Agents API

Manage agents and skills.

Agent Endpoints

List Agents

GET /api/v1/agents?project_path={path}

Get Agent

GET /api/v1/agents/{scope}/{name}?project_path={path}

Create Agent

POST /api/v1/agents?project_path={path}

{
  "name": "reviewer",
  "scope": "user",
  "description": "Code review specialist",
  "tools": ["Read", "Grep", "Glob"],
  "disallowed_tools": ["Write", "Bash"],
  "model": "claude-sonnet-4-6",
  "permission_mode": "default",
  "skills": ["code-review"],
  "memory": "user",
  "prompt": "You are a code review specialist..."
}

Update Agent

PUT /api/v1/agents/{scope}/{name}?project_path={path}

Delete Agent

DELETE /api/v1/agents/{scope}/{name}?project_path={path}

Skill Endpoints

List Skills

GET /api/v1/agents/skills?project_path={path}

Get Skill

GET /api/v1/agents/skills/{location}/{name}?project_path={path}&include_deps={bool}

Check Dependencies

GET /api/v1/agents/skills/{location}/{name}/dependencies?project_path={path}

Install Dependencies

POST /api/v1/agents/skills/{location}/{name}/install?project_path={path}

List Skill Files

GET /api/v1/agents/skills/{location}/{name}/files?project_path={path}

Search Registry

GET /api/v1/agents/skills/registry?query={q}&limit={n}

Install from Registry

POST /api/v1/agents/skills/registry/install?project_path={path}

{
  "source": "https://skills.sh/owner/skill",
  "skill_names": ["skill-name"],
  "global_install": true
}