Invoke Skill Playbook Creator
post
/api/v1/skills/playbook.creator/invokeDraft a new workstream conversationally — describe a workflow and Archie produces a structured, reviewable workstream draft with typed steps, dependencies, and validation. Legacy slug retained for back-compat; prefer `workstream.draft` for new integrations.
Request bodyapplication/json
| Field | Type | Description |
|---|---|---|
descriptionrequired | string | Natural-language description of the workflow to draft. |
topic_id | string | null | Topic to anchor the draft to — permakey (preferred) or UUID. |
prior_draft_id | string (uuid) | null | Optional prior draft to iterate on instead of creating a new one. |
Responses
200Skill executed successfully
| Field | Type | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
skillrequired | string | — | ||||||||||||||||||||||||
outputrequired | object | Output from the workstream drafting skill — pointer to the draft + summary.
``draft_id`` is None when the request couldn't produce a draft (missing
workspace / topic / generation failure); in that case ``error`` carries
a one-line reason. Successful invocations always set ``draft_id``.show nested
| ||||||||||||||||||||||||
correlation_idrequired | string | — |
401Authentication required
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
403Insufficient permissions
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
404Skill not found
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
429Rate limit exceeded
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
5XXInternal server error
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
curl https://api.dev.arch.ie/api/v1/skills/playbook.creator/invoke \
-X POST \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"description": "string",
"topic_id": null,
"prior_draft_id": null
}'