Invoke Skill Communications Draft
post
/api/v1/skills/communications.draft/invokeDraft a client communication — email, letter, memo, or report.
Request bodyapplication/json
| Field | Type | Description |
|---|---|---|
typerequired | "email" | "letter" | "memo" | "report" | —emaillettermemoreport |
recipientsrequired | string[] | — |
subject | string | — |
context | string | — |
tone | "formal" | "friendly" | "urgent" | —formalfriendlyurgent |
Responses
200Skill executed successfully
| Field | Type | Description | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
skillrequired | string | — | |||||||||||||||||||||
outputrequired | object | —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/communications.draft/invoke \
-X POST \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"type": "email",
"recipients": [
"string"
],
"subject": "string",
"context": "string",
"tone": "formal"
}'