Invoke Skill Workstream Commit

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

Promote a workstream draft to an active, executable workstream definition. The draft must validate cleanly; the resulting workstream gets a new permakey and becomes runnable via workstream_run.

Request bodyapplication/json

Field	Type	Description
`draft_id`required	`string (uuid)`	The draft id from `workstream_draft.draft_id`.
`scope`	`"user" \| "team" \| "firm"`	Authoring scope for the committed workstream. `userteamfirm`
`name`	`string \| null`	Optional final name. Defaults to the draft's working name. Cannot collide with another active workstream in the workspace.
`idempotency_key`	`string \| null`	Caller-supplied stable token. Replaying within 24h returns the previously-created workstream id rather than erroring on the name collision.

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

Pointer to the committed workstream.

show nested

Field	Type	Description
`stub_fields`	`string[]`	—
`warnings`	`string[]`	—
`workstream_id`	`string (uuid) \| null`	Newly-created workstream id.
`permakey`	`string`	7-char human-friendly id for URLs and Slack.
`status`	`"draft" \| "active"`	`active` on success; `draft` if commit failed validation and the draft still exists. `draftactive`
`error`	`string \| null`	—
`error_envelope`	`any \| null`	Canonical structured error. Populated when commit 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.commit/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "draft_id": "00000000-0000-0000-0000-000000000000",
       "scope": "user",
       "name": null,
       "idempotency_key": null
     }'