Invoke Skill Workstream List

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

List workstreams visible to the caller. Filter by scope (plan / user / team / firm / gallery) and lifecycle status. Returns summary rows including execution_mode so callers can distinguish inline (Temporal-native, declarative) from container (Fly.io, agentic) workstreams.

Request bodyapplication/json

Field	Type	Description
`scope`	`"plan" \| "user" \| "team" \| "firm" \| "gallery" \| null`	Limit to workstreams of this authoring scope.
`status`	`"draft" \| "active" \| "archived" \| null`	Limit to workstreams with this lifecycle status.
`limit`	`integer`	Maximum rows per page (1..100). Defaults to 20.
`cursor`	`string \| null`	Opaque pagination cursor from a previous response's `next_cursor`. Omit on the first call. The server treats the cursor as opaque — do not parse or construct it.

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

List of workstreams the caller can see, with cursor pagination.

show nested

Field	Type	Description
`stub_fields`	`string[]`	—
`warnings`	`string[]`	—
`items`	`any[]`	Page of workstreams matching the input filters.
`next_cursor`	`string \| null`	Pass back as `cursor` on the next call to get the following page. `None` when there are no more pages.
`total`	`integer \| null`	Total matching rows across all pages. `None` when the backend cannot count cheaply (very large datasets).

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.list/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "scope": null,
       "status": null,
       "limit": 0,
       "cursor": null
     }'