Strait Docs
CLI

Manage and trigger jobs via the CLI.

jobs list

List jobs for a project.

strait jobs list --project proj_1
FlagTypeDescription
--projectstringProject ID

jobs get

Get a job by ID or slug.

strait jobs get job_abc123
strait jobs get send-email

jobs create

Create a new job.

strait jobs create \
  --name "Send Email" \
  --slug send-email \
  --endpoint http://localhost:3000/jobs/send-email \
  --timeout-secs 60 \
  --max-attempts 3
FlagTypeDefaultDescription
--projectstringProject ID
--namestringJob name
--slugstringJob slug
--descriptionstringJob description
--cronstringCron schedule expression
--endpointstringJob endpoint URL
--timeout-secsint60Execution timeout in seconds
--max-attemptsint3Maximum retry attempts
--run-ttl-secsint0Run TTL in seconds (0 = no expiry)

jobs edit

Update an existing job.

strait jobs edit send-email --field timeout_secs=120
FlagTypeDescription
--fieldstringField update in key=value form
--editorstringEditor command for interactive mode

jobs delete

Disable a job by ID or slug.

strait jobs delete send-email --yes
FlagTypeDefaultDescription
--yesboolfalseSkip confirmation prompt

jobs trigger

Trigger a job run.

strait jobs trigger send-email --payload '{"to": "user@example.com"}'
FlagTypeDefaultDescription
--payloadstringInline JSON payload
--payload-filestringPath to payload JSON file
--priorityint0Run priority
--scheduled-atstringRFC3339 timestamp for delayed execution
--idempotency-keystringIdempotency key

jobs trigger-bulk

Trigger multiple runs for a job.

strait jobs trigger-bulk send-email --items-file items.json
FlagTypeDescription
--items-jsonstringJSON array of bulk trigger items
--items-filestringPath to JSON file with bulk trigger items

jobs versions

List version history for a job.

strait jobs versions send-email

jobs describe

Show rich details and recent runs for a job.

strait jobs describe send-email
Was this page helpful?

On this page