Skills
Execute Skill
Execute a skill manually or perform a dry run
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 pendingboolean
Whether this was a dry run
object
array
Delivery results for each configured channel.