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.
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
-
List the skills:
GET https://app.adaptleads.co.uk/api/market/skills Authorization: Bearer <sign-in token> -
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?"} ```
skillisarea/name.inputis up to 4,000 characters and may not be empty.page.routeis optional. No other field is accepted. -
Read the reply. It holds
reply,cards,actions,run_id,usageandruns_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.