Skip to main content
POST
/
manage-skills
curl -X POST https://api.magpipe.ai/functions/v1/manage-skills \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "YOUR_AGENT_ID",
    "skill_definition_id": "SKILL_DEF_ID",
    "config": {
      "keywords": ["AI voice agent"],
      "platforms": ["reddit", "hackernews", "x"]
    },
    "delivery_channels": [
      { "channel": "slack", "channel_name": "#alerts" },
      { "channel": "email" }
    ]
  }'

{
  "agent_skill": {
    "id": "7a99a0af-...",
    "agent_id": "7f806f26-...",
    "skill_definition_id": "a1b2c3d4-...",
    "is_enabled": true,
    "config": {
      "keywords": ["AI voice agent"],
      "platforms": ["reddit", "hackernews", "x"]
    },
    "delivery_channels": [
      { "channel": "slack", "channel_name": "#alerts" },
      { "channel": "email" }
    ],
    "skill_definitions": {
      "slug": "social_media_monitoring",
      "name": "Social Media Monitoring"
    }
  }
}
Enable a skill from the catalog for a specific agent. If the skill was previously enabled and removed, this will re-create it with the provided configuration.

​
Request Body

​
agent_id
string
required
The agent to enable the skill for.
​
skill_definition_id
string
required
The skill definition ID from the catalog. Get this from List Skill Definitions.
​
config
object
Skill-specific configuration. See the skill’s config_schema for available options.
​
trigger_type
string
How the skill should fire: event or schedule.
​
delivery_channels
array
Where to deliver results. Each entry has a channel (slack, email, sms) and optional channel_name.

​
Response

​
agent_skill
object
The created agent skill object.
curl -X POST https://api.magpipe.ai/functions/v1/manage-skills \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "YOUR_AGENT_ID",
    "skill_definition_id": "SKILL_DEF_ID",
    "config": {
      "keywords": ["AI voice agent"],
      "platforms": ["reddit", "hackernews", "x"]
    },
    "delivery_channels": [
      { "channel": "slack", "channel_name": "#alerts" },
      { "channel": "email" }
    ]
  }'

{
  "agent_skill": {
    "id": "7a99a0af-...",
    "agent_id": "7f806f26-...",
    "skill_definition_id": "a1b2c3d4-...",
    "is_enabled": true,
    "config": {
      "keywords": ["AI voice agent"],
      "platforms": ["reddit", "hackernews", "x"]
    },
    "delivery_channels": [
      { "channel": "slack", "channel_name": "#alerts" },
      { "channel": "email" }
    ],
    "skill_definitions": {
      "slug": "social_media_monitoring",
      "name": "Social Media Monitoring"
    }
  }
}