Skip to main content
POST
Trigger a skill execution manually. Use dry_run: true to preview what the skill would do without sending any messages or making changes.

Path Parameters

string
required
The agent skill ID to execute.

Request Body

boolean
default:false
If true, returns a preview without executing delivery or side effects.
object
Optional context data passed to the skill handler. For event-based skills, this includes call data like caller_phone, call_summary, extracted_data.

Response

boolean
Whether the execution succeeded
string
Execution record ID (not present for dry runs)
string
completed, failed, or pending
boolean
Whether this was a dry run
object
array
Delivery results for each configured channel.