Enable Skill

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"
    }
  }
}

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

string

required

The agent to enable the skill for.

string

required

The skill definition ID from the catalog. Get this from List Skill Definitions.

object

Skill-specific configuration. See the skill’s config_schema for available options.

string

How the skill should fire: event or schedule.

array

Where to deliver results. Each entry has a channel (slack, email, sms) and optional channel_name.

Response

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"
    }
  }
}

API Reference

Agents

Custom Functions

Dynamic Variables

Memory

Calls

Call Whitelist

Skills

Batch Calls

Testing

Messages

Phone Numbers

Chat Widget

Knowledge Base

Voice

Models

Calendar

Contacts

Billing

Scheduled Actions

API Keys & Webhooks

Request Body

Response

​Request Body

​Response

Request Body

Response