agent-manager-dev Releases API

openapi: 3.2.0
info:
  title: agent-manager reference Releases 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: Releases
  description: The current release and how to install it.
paths:
  /api/release:
    get:
      operationId: getLatestRelease
      tags:
      - Releases
      summary: Latest release and install commands
      description: The newest published release, read live from the project's GitHub releases, together with the install command for every package manager the project supports.
      parameters:
      - name: install_method
        in: query
        required: false
        description: Return the install command for this package manager only.
        schema:
          type: string
          enum:
          - homebrew
          - cask
          - script
          - aur
          - mise
          - go
          - scoop
          - windows
      responses:
        '200':
          description: The current release.
          content:
            application/json:
              schema:
                type: object
                required:
                - version
                - url
                - install
                properties:
                  version:
                    type: string
                    description: Tag of the newest release.
                  url:
                    type: string
                    format: uri
                  published_at:
                    type: string
                    format: date-time
                  install:
                    type: array
                    items:
                      type: object
                      required:
                      - id
                      - name
                      - command
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        command:
                          type: string
                        platforms:
                          type: array
                          items:
                            type: string
        '400':
          description: A parameter is missing or out of range.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: A source this endpoint reads from could not be reached.
          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.
externalDocs:
  description: Documentation
  url: https://agent-manager.dev/docs/