Mobius

Sign inGet started
GuidesAPI Reference
Sign inGet started

Unsorted (new)

The Agent Capabilities tag group covers the endpoints you use to build a project-scoped catalog of toolkits and skills, assign them to agents, and resolve the effective capability manifest the runtime uses at invocation time. It is the narrative counterpart to the Redoc reference for agent-capabilities; if you need exact request or response shapes, click through to Redoc.

Typical flow

  1. POST /v1/projects/{project}/toolkits — register a project-local toolkit with native tool grants and action grants. Returns a tk_... toolkit ID.
  2. POST /v1/projects/{project}/skills or POST /v1/projects/{project}/skills:import — author a skill with instructions and requested tools/actions, or import a Claude Code or Dive-style skill document.
  3. PUT /v1/projects/{project}/agents/{id}/toolkits — replace the agent's toolkit assignment set. The body is a list of toolkit IDs in the order you want applied.
  4. PUT /v1/projects/{project}/agents/{id}/skills — replace the agent's skill assignment set the same way.
  5. GET /v1/projects/{project}/agents/{id}/capability-manifest — resolve the effective manifest. The response intersects toolkit grants with the agent's service-account permissions and applies the optional toolkit_ids, skill_name, allowed_tools, and allowed_actions query filters.

GET /v1/projects/{project}/toolkits and GET /v1/projects/{project}/skills return both project-local entries and read-only system templates; pass include_system=false to hide the system rows.

Authentication

All operations use the API-wide Bearer scheme described on the API keys page. Toolkit and skill catalog endpoints are project-scoped, so the key must be able to see the target project.

Common errors

CodeHTTPCauseFix
bad_request400Toolkit, skill, or replace-assignments body fails schema validation.Inspect the response body and correct the offending fields.
unauthorized401Missing or invalid API key.Send a current Bearer token from the API keys page.
not_found404Toolkit, skill, or agent ID is unknown or not visible to your key.Confirm the project handle and that the ID exists in that project.
conflict409Toolkit or skill name already exists in the project, or the resource is still in use.Choose a different name, or detach assignments before deleting.

See also

  • Agents — the mental model for agents, service accounts, and session presence.
  • Agent Capabilities (Redoc) — full request and response schemas for every endpoint cited above.