Run a skill

List the skills and run one through the app's routes with a sign-in token, then read the reply and any cards.

How-toDeveloperChecked 2026-10-10

You will have a skill's reply and any approval cards it prepared. Skills run through the app's routes. The MCP connector does not run skills.

Before you start

A sign-in token from POST /market/auth/login: see How the app's API is organised.

Steps

  1. List the skills:

    GET https://app.adaptleads.co.uk/api/market/skills Authorization: Bearer <sign-in token>

  2. Run one:

    ``` POST https://app.adaptleads.co.uk/api/market/skills/run Authorization: Bearer Content-Type: application/json

    {"skill": "platform-help/answer-a-question", "input": "How do I export a list?"} ```

    skill is area/name. input is up to 4,000 characters and may not be empty. page.route is optional. No other field is accepted.

  3. Read the reply. It holds reply, cards, actions, run_id, usage and runs_left_today. A card is something the skill prepared. A person approves it in the app: How prepared changes reach you for approval.

Limits

Runs a day depend on your plan: 8 on the free trial, then 30, 60, 120 and 250 from Solo up to Scale, reset at midnight UK time. A request body can be 20,000 bytes at most. See Plans, prices and limits.

If it fails

Status Meaning
404 The AI layer is switched off, or the skill name is wrong
400 The body is not JSON, or input is empty
422 A field is not allowed, or skill is missing
429 A daily or monthly cap. The message says when it resets
503 The helper is busy. Try again shortly

The three skills on the shelf are described in The public shelf. More: Run a skill.