Create Job Definition Api V1 Workstreams Jobs Post

post/api/v1/workstreams/jobs

Create job definition

Create a new agentic job definition.

Request bodyapplication/json

Field	Type	Description
`name`required	`string`	—
`description`	`string \| null`	—
`domain`required	`string`	Domain knowledge key (e.g. 'ita_2007_eis')
`goal_template`	`string \| null`	Goal template with {{variable}} placeholders. OPTIONAL: when omitted (or null), it is defaulted server-side from the domain's DomainAgent persona goal_template (PERSONA_REGISTRY.for_workstream(domain)). A domain with no registered persona falls back to the DEFAULT persona's '{{ goal }}'. An explicit value is stored verbatim (back-compat).
`tools`	`string[]`	—
`deliverables`	`object[]`	— item shape Empty object.
`max_turns`	`integer`	—
`max_cost_usd`	`number`	—
`max_duration_minutes`	`integer`	—
`target_selector`	`TargetSelector`	Who to run the job for. show nested TargetSelector
`per_client_overrides`	`object`	— show nested Empty object.
`default_context`	`object`	— show nested Empty object.
`source_tracing`	`boolean`	—
`human_checkpoints`	`string[]`	—
`schedule`	`string \| null`	Cron expression
`schedule_timezone`	`string`	—

Responses

201Successful 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 \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "name": "string",
       "description": null,
       "domain": "string",
       "goal_template": null,
       "tools": [
         "string"
       ],
       "deliverables": [
         {}
       ],
       "max_turns": 0,
       "max_cost_usd": 0,
       "max_duration_minutes": 0,
       "target_selector": {
         "type": "string",
         "client_ids": null,
         "client_id": null,
         "tag": null
       },
       "per_client_overrides": {},
       "default_context": {},
       "source_tracing": false,
       "human_checkpoints": [
         "string"
       ],
       "schedule": null,
       "schedule_timezone": "string"
     }'