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}'
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 '{}'
{
"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"
}
}
{
"success": true,
"execution_id": "b425a0b3-...",
"status": "completed",
"result": {
"summary": "Social Media Monitor: 20 new mention(s) found\n\n📋 *Summary*\n...",
"actions_taken": ["mentions_found"],
"data": {
"keywords": ["AI voice agent"],
"new_mentions": 20,
"platforms": ["reddit", "hackernews", "x"]
}
},
"deliveries": [
{ "channel": "slack", "status": "sent", "to": "#general" },
{ "channel": "email", "status": "sent" }
]
}
Skills
Execute Skill
Execute a skill manually or perform a dry run
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}'
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 '{}'
{
"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"
}
}
{
"success": true,
"execution_id": "b425a0b3-...",
"status": "completed",
"result": {
"summary": "Social Media Monitor: 20 new mention(s) found\n\n📋 *Summary*\n...",
"actions_taken": ["mentions_found"],
"data": {
"keywords": ["AI voice agent"],
"new_mentions": 20,
"platforms": ["reddit", "hackernews", "x"]
}
},
"deliveries": [
{ "channel": "slack", "status": "sent", "to": "#general" },
{ "channel": "email", "status": "sent" }
]
}
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
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}'
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 '{}'
{
"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"
}
}
{
"success": true,
"execution_id": "b425a0b3-...",
"status": "completed",
"result": {
"summary": "Social Media Monitor: 20 new mention(s) found\n\n📋 *Summary*\n...",
"actions_taken": ["mentions_found"],
"data": {
"keywords": ["AI voice agent"],
"new_mentions": 20,
"platforms": ["reddit", "hackernews", "x"]
}
},
"deliveries": [
{ "channel": "slack", "status": "sent", "to": "#general" },
{ "channel": "email", "status": "sent" }
]
}