Invoke Skill Workstream Status

post/api/v1/skills/workstream.status/invoke

Get the current status of a workstream run — overall lifecycle state plus current/next step pointers and progress percentage. For live progress streaming, use the events_url returned by workstream_run instead.

Request bodyapplication/json

Field	Type	Description
`cycle_id`required	`string (uuid)`	The cycle id returned by workstream_run.

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

Current cycle state — overall + per-step. Emits both ``cycle_id`` (canonical) and ``run_id`` (deprecated alias, populated alongside ``cycle_id``) for backwards compat.

show nested

Field	Type	Description
`stub_fields`	`string[]`	—
`warnings`	`string[]`	—
`cycle_id`	`string (uuid) \| null`	The cycle being inspected.
`run_id`	`string (uuid) \| null`	—
`status`	`"pending" \| "running" \| "paused" \| "awaiting_approval" \| "completed" \| "cancelled" \| "failed"`	Lifecycle state of the cycle. `pendingrunningpausedawaiting_approvalcompletedcancelledfailed`
`current_step`	`string`	Slug of the currently-executing step (empty if not yet started).
`next_step`	`string \| null`	Slug of the next step the runtime will dispatch (None on terminal states).
`progress_pct`	`number`	Approximate completion percentage (0..100).
`error`	`string \| null`	—
`error_envelope`	`any \| null`	Canonical structured error. Populated when `status == 'failed'`.

correlation_idrequired string —

401Authentication required

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

403Insufficient permissions

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

404Skill not found

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

429Rate limit exceeded

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

5XXInternal server error

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

curl https://api.dev.arch.ie/api/v1/skills/workstream.status/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "cycle_id": "00000000-0000-0000-0000-000000000000"
     }'