Skills & agents

Run templated skills, manage agents, and work with artifacts from your own systems.

Skills

List skills

GET /api/skills

{
  "skills": [
    { "id": "persona-v1", "name": "Buyer Persona Generator", "category": "Research", "description": "…" }
  ]
}

Run a skill

POST /api/skills/exec

Field	Type	Required	Description
`skillId`	string	✅	A skill `id` from `/api/skills`.
`vars`	object	—	Key/value inputs for the skill’s variables.

curl https://ai.mixerlead.com/api/skills/exec \
  -H "Authorization: Bearer $MIXERLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skillId": "messaging-framework",
    "vars": { "company": "ACME", "audience": "RevOps leaders", "tone": "confident" }
  }'

{ "output": "## Messaging architecture for ACME …" }

Agents

List agents

GET /api/agents

Returns agents in the active project.

Create an agent

POST /api/agents

Field	Type	Description
`name`	string	Display name.
`type`	string	`research`, `strategy`, `execution`, or `monitoring`.
`config`	object	Agent configuration.

curl https://ai.mixerlead.com/api/agents \
  -H "Authorization: Bearer $MIXERLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "ACME competitor watch", "type": "monitoring", "config": {} }'

Run an agent

POST /api/agents/{id}/run

Runs the agent and returns its output. Agent runs consume credits and count against your plan’s daily agent‑run quota — see Usage & limits.

curl -X POST https://ai.mixerlead.com/api/agents/ag_123/run \
  -H "Authorization: Bearer $MIXERLEAD_API_KEY"

Artifacts

List artifacts

GET /api/artifacts

Save an artifact

POST /api/artifacts

Persist output (such as a generated document) to your workspace for reuse.

Skills Library The skills catalog in the app.

Agent Studio Build agents in the app.

Errors & rate limits Status codes and retries.