Skip to main content
POST
/
manage-skills
/
{id}
/
execute
curl -X POST https://api.magpipe.ai/functions/v1/manage-skills/SKILL_ID/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dry_run": true}'

{
  "success": true,
  "status": "completed",
  "dry_run": true,
  "result": {
    "summary": "Would monitor 2 keyword(s) across reddit, hackernews, x",
    "actions_taken": ["preview"],
    "preview": "Keywords: AI voice agent, magpipe\nPlatforms: reddit, hackernews, x"
  }
}
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

​
id
string
required
The agent skill ID to execute.

​
Request Body

​
dry_run
boolean
default:false
If true, returns a preview without executing delivery or side effects.
​
trigger_context
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

​
success
boolean
Whether the execution succeeded
​
execution_id
string
Execution record ID (not present for dry runs)
​
status
string
completed, failed, or pending
​
dry_run
boolean
Whether this was a dry run
​
result
object
​
deliveries
array
Delivery results for each configured channel.
curl -X POST https://api.magpipe.ai/functions/v1/manage-skills/SKILL_ID/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dry_run": true}'

{
  "success": true,
  "status": "completed",
  "dry_run": true,
  "result": {
    "summary": "Would monitor 2 keyword(s) across reddit, hackernews, x",
    "actions_taken": ["preview"],
    "preview": "Keywords: AI voice agent, magpipe\nPlatforms: reddit, hackernews, x"
  }
}