Update Job Definition Api V1 Workstreams Jobs Job Id Patch

patch/api/v1/workstreams/jobs/{job_id}

Update job definition

Update a job definition (by ID or permakey).

Path parameters

job_idrequired

path

—

Request bodyapplication/json

Field	Type	Description
`name`	`string \| null`	—
`description`	`string \| null`	—
`goal_template`	`string \| null`	—
`tools`	`string[] \| null`	—
`deliverables`	`object[] \| null`	—
`max_turns`	`integer \| null`	—
`max_cost_usd`	`number \| null`	—
`max_duration_minutes`	`integer \| null`	—
`target_selector`	`TargetSelector \| null`	—
`per_client_overrides`	`object \| null`	—
`default_context`	`object \| null`	—
`source_tracing`	`boolean \| null`	—
`human_checkpoints`	`string[] \| null`	—
`schedule`	`string \| null`	—
`schedule_timezone`	`string \| null`	—
`is_enabled`	`boolean \| null`	—
`status`	`string \| null`	—

Responses

200Successful Response

Field	Type	Description
`id`required	`string (uuid)`	—
`permakey`	`string \| null`	Stable human-readable key for the batch/fan-out deep-link URL /workstreams/{ws}/cycles/{permakey}/… (#173). Null on legacy rows.
`name`required	`string`	—
`description`	`string \| null`	—
`domain`required	`string`	—
`goal_template`required	`string`	—
`tools`required	`string[]`	—
`deliverables`required	`object[]`	— item shape Empty object.
`max_turns`required	`integer`	—
`max_cost_usd`required	`number`	—
`max_duration_minutes`required	`integer`	—
`target_selector`required	`object`	— show nested Empty object.
`per_client_overrides`required	`object`	— show nested Empty object.
`default_context`required	`object`	— show nested Empty object.
`source_tracing`required	`boolean`	—
`human_checkpoints`required	`string[]`	—
`schedule`	`string \| null`	—
`schedule_timezone`required	`string`	—
`is_enabled`required	`boolean`	—
`next_run_at`	`any \| null`	—
`last_run_at`	`any \| null`	—
`status`required	`string`	—
`created_by`required	`string`	—
`created_at`required	`any`	—
`updated_at`required	`any`	—
`current_version`	`integer \| null`	Latest version number in job_definition_version; null if no history yet.

422Validation Error

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

curl https://api.dev.arch.ie/api/v1/workstreams/jobs/<job_id> \
  -X PATCH \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "name": null,
       "description": null,
       "goal_template": null,
       "tools": null,
       "deliverables": null,
       "max_turns": null,
       "max_cost_usd": null,
       "max_duration_minutes": null,
       "target_selector": null,
       "per_client_overrides": null,
       "default_context": null,
       "source_tracing": null,
       "human_checkpoints": null,
       "schedule": null,
       "schedule_timezone": null,
       "is_enabled": null,
       "status": null
     }'