Create Agent Cycle Api V1 Workstreams Cycles Agent Post

post/api/v1/workstreams/cycles/agent

Start agentic cycle

Start a new agentic workstream cycle. Instead of a rigid step-based WDL, the agent receives a goal, tools, and context, then works autonomously toward producing the required deliverables. **Authentication Required:** JWT Bearer token

Request bodyapplication/json

Field	Type	Description
`goal`required	`string`	What the agent should accomplish
`domain`required	`string`	Domain knowledge key (e.g. 'ita_2007_eis')
`client_id`	`string (uuid) \| null`	Client UUID
`context`	`object`	Client context data show nested Empty object.
`tools`	`string[]`	Tools the agent may use (empty = all available)
`deliverables`	`object[]`	Required deliverables [{name, type, description}] item shape Empty object.
`max_turns`	`integer`	—
`max_cost_usd`	`number`	—
`max_duration_minutes`	`integer`	—
`source_tracing`	`boolean`	Enable source tracing guardrail

Responses

201Agentic cycle started

Field	Type	Description
`cycle_id`required	`string`	—
`workflow_id`required	`string`	—
`status`required	`string`	—

401Unauthorized

422Validation Error

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

504Temporal timeout

curl https://api.dev.arch.ie/api/v1/workstreams/cycles/agent \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "goal": "string",
       "domain": "string",
       "client_id": null,
       "context": {},
       "tools": [
         "string"
       ],
       "deliverables": [
         {}
       ],
       "max_turns": 0,
       "max_cost_usd": 0,
       "max_duration_minutes": 0,
       "source_tracing": false
     }'