agent-manager-dev Product API

openapi: 3.2.0
info:
  title: agent-manager reference Product API
  version: 1.0.0
  summary: Read-only reference data about agent-manager.
  description: 'This is the public read-only API for agent-manager''s reference data: the documentation, the coding CLIs it manages, the tools its MCP server exposes, and the current release. Driving agent-manager itself happens on the developer''s own machine through the MCP server that ships in the binary, not through this API.


    ## Versioning and deprecation


    Every path is available unversioned and pinned: `/api/docs` always points at the newest

    version, `/api/v1/docs` stays on v1. A breaking change to a response shape ships under a new

    `/api/v2` prefix, never in place.


    Every response carries `API-Version` with the version that produced it and `Deprecation:

    false`. When a version is scheduled for removal, that header becomes an IMF-fixdate per RFC

    9745 and a `Sunset` header per RFC 8594 names the date the version stops answering, at least

    180 days ahead. A `Link: rel="deprecation"` on the same response points at the migration note.


    ## Rate limits


    The published budget is 600 requests per 60 seconds per caller, advertised on every response

    through `RateLimit`, `RateLimit-Policy`, `RateLimit-Limit`, `RateLimit-Remaining` and

    `RateLimit-Reset`. A throttled request answers `429` with `Retry-After`.


    ## Authentication


    None. Every endpoint is public and read-only; see /auth.md.'
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  contact:
    name: agent-manager issues
    url: https://github.com/YoanWai/agent-manager/issues
servers:
- url: https://agent-manager.dev
  description: Production, newest version
- url: https://agent-manager.dev/api/v1
  description: Production, pinned to v1
security: []
tags:
- name: Product
  description: The CLIs agent-manager manages and the tools it exposes.
paths:
  /api/agents:
    get:
      operationId: listSupportedAgents
      tags:
      - Product
      summary: Coding CLIs with built-in status detection
      description: 'The coding CLIs agent-manager ships a working profile for: the command it runs, where its live status comes from, and how it resumes a conversation. A CLI outside the list is a feature request.'
      parameters:
      - name: id
        in: query
        required: false
        description: Return only this profile, by its id, such as claude or codex.
        schema:
          type: string
          enum:
          - claude
          - codex
          - opencode
          - grok
          - gemini
          - antigravity
          - pi
          - command-code
          - hermes
          - muse
          - omp
          - cursor
      responses:
        '200':
          description: The built-in agent profiles.
          content:
            application/json:
              schema:
                type: object
                required:
                - count
                - agents
                properties:
                  count:
                    type: integer
                  note:
                    type: string
                  agents:
                    type: array
                    items:
                      $ref: '#/components/schemas/Agent'
        '400':
          description: A parameter is missing or out of range.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '405':
          description: The path exists but not for that HTTP method.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '406':
          description: No representation matches the request's Accept header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /api/mcp/tools:
    get:
      operationId: listMcpTools
      tags:
      - Product
      summary: Tools the agent-manager MCP server exposes
      description: The tools the MCP server inside the agent-manager binary registers into every MCP-capable session it starts, grouped by what they act on. These run on the developer's machine, not here.
      parameters:
      - name: group
        in: query
        required: false
        description: Return only the tools that act on this part of the workspace.
        schema:
          type: string
          enum:
          - coordination
          - groups
          - review
          - session
          - terminals
      responses:
        '200':
          description: The MCP tool catalogue.
          content:
            application/json:
              schema:
                type: object
                required:
                - count
                - tools
                properties:
                  count:
                    type: integer
                  transport:
                    type: string
                    description: 'How these tools are reached: stdio, inside the binary.'
                  note:
                    type: string
                  tools:
                    type: array
                    items:
                      $ref: '#/components/schemas/McpTool'
        '400':
          description: A parameter is missing or out of range.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '405':
          description: The path exists but not for that HTTP method.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '406':
          description: No representation matches the request's Accept header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
      - error
      description: Every failing response on this API has this shape.
      properties:
        error:
          type: object
          required:
          - code
          - message
          - status
          properties:
            code:
              type: string
              enum:
              - invalid_request
              - not_found
              - method_not_allowed
              - not_acceptable
              - upstream_unavailable
              description: Stable machine-readable error code.
            message:
              type: string
              description: What went wrong, in one sentence.
            status:
              type: integer
              description: The HTTP status of this response.
            hint:
              type: string
              description: What to try instead.
            documentation_url:
              type: string
              format: uri
              description: Where this endpoint is documented.
    McpTool:
      type: object
      required:
      - name
      - summary
      properties:
        name:
          type: string
        group:
          type: string
          description: 'What the tool acts on: session, review, coordination, groups or terminals.'
        summary:
          type: string
    Agent:
      type: object
      required:
      - id
      - name
      - command
      properties:
        id:
          type: string
          description: The CLI's id in agent-manager, such as claude or codex.
        name:
          type: string
        command:
          type: string
          description: The command the session runs.
        status_source:
          type: string
          description: Where the row's live status comes from.
        resume:
          type: string
          description: How a conversation is resumed or forked.
externalDocs:
  description: Documentation
  url: https://agent-manager.dev/docs/