Run Job Api V1 Workstreams Jobs Job Id Run Post

post/api/v1/workstreams/jobs/{job_id}/run

Run job (fan-out across clients)

Resolve the job's target_selector to a list of clients, then create one agentic cycle per client and start Temporal workflows. If `client_ids` is provided in the request body, it overrides the job's target_selector (useful for manual runs on a subset).

Path parameters

job_idrequired

path

—

Request bodyapplication/json

FanOutRequest | null

Responses

201Successful Response

Field	Type	Description
`job_definition_id`required	`string`	—
`job_permakey`	`string \| null`	Job permakey for the batch deep-link URL (#173); null on legacy rows.
`total_clients`required	`integer`	—
`cycles_created`required	`integer`	—
`cycles_failed`required	`integer`	—
`cycles`required	`object[]`	— item shape Empty object.
`errors`required	`object[]`	— item shape Empty object.

422Validation Error

Field	Type	Description
`detail`	`ValidationError[]`	— item shape ValidationError

curl https://api.dev.arch.ie/api/v1/workstreams/jobs/<job_id>/run \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d 'null'