agent-manager-dev

agent-manager-dev Docs API

The documentation, as data and as Markdown.

Documentation GitHub OpenAPI

Operations 4

GET /api/docs List every page on this site #

GET /api/docs/{slug} Read one page as Markdown #

POST /ask Ask a question in natural language (NLWeb) #

GET /api/search Search the documentation #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/agent-manager-dev:agent-manager-dev-docs-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: agent-manager reference Docs 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: Docs
  description: The documentation, as data and as Markdown.
paths:
  /api/docs:
    get:
      operationId: listDocPages
      tags:
      - Docs
      summary: List every page on this site
      description: Returns the title, description, section, canonical URL and Markdown URL of every page agent-manager.dev publishes. Use the returned slug with getDocPage to read one.
      parameters:
      - name: section
        in: query
        required: false
        description: Return only pages in this section, such as Documentation.
        schema:
          type: string
      - name: cursor
        in: query
        required: false
        description: The next_cursor from the previous response. Cursor-based, so a page added mid-walk cannot shift the window.
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: How many pages to return in this window.
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
      responses:
        '200':
          description: Every page, newest structure first.
          content:
            application/json:
              schema:
                type: object
                required:
                - count
                - total
                - pages
                properties:
                  count:
                    type: integer
                    description: Pages in this window.
                  total:
                    type: integer
                    description: Pages matching the filter.
                  next_cursor:
                    type:
                    - string
                    - 'null'
                    description: Pass back as cursor for the next window; null when this is the last one.
                  sections:
                    type: array
                    items:
                      type: string
                  pages:
                    type: array
                    items:
                      $ref: '#/components/schemas/PageSummary'
        '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/docs/{slug}:
    get:
      operationId: getDocPage
      tags:
      - Docs
      summary: Read one page as Markdown
      description: Returns one page's metadata together with its full body as Markdown, with the site chrome removed. The slug is the one listDocPages returns and may contain slashes.
      parameters:
      - name: slug
        in: path
        required: true
        description: Page slug from listDocPages, for example install or writing/live-review-race.
        schema:
          type: string
      responses:
        '200':
          description: The page and its Markdown body.
          content:
            application/json:
              schema:
                type: object
                required:
                - slug
                - title
                - url
                - markdown_url
                - section
                - markdown
                properties:
                  slug:
                    type: string
                    description: Identifier for getDocPage.
                  title:
                    type: string
                  description:
                    type: string
                  section:
                    type: string
                    description: Documentation, Writing, or Site.
                  url:
                    type: string
                    format: uri
                    description: Canonical HTML URL.
                  markdown_url:
                    type: string
                    format: uri
                    description: 'Same page as Markdown; the HTML URL also serves it under Accept: text/markdown.'
                  markdown:
                    type: string
                    description: The page body as Markdown.
        '404':
          description: No resource exists at that path.
          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'
  /ask:
    post:
      operationId: askNaturalLanguage
      tags:
      - Docs
      summary: Ask a question in natural language (NLWeb)
      description: 'An NLWeb-shaped endpoint: takes a natural-language query and returns ranked pages with schema.org objects. Send Accept: text/event-stream, or streaming true, for an SSE stream of start, result and complete events.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  minLength: 1
                  description: The question, in natural language.
                mode:
                  type: string
                  enum:
                  - list
                  - summarize
                  - generate
                  default: list
                site:
                  type: string
                  description: Scope token; this host serves one site.
                query_id:
                  type: string
                  description: Echoed back; generated when absent.
                streaming:
                  type: boolean
                  description: Ask for SSE instead of JSON.
      responses:
        '200':
          description: Ranked results for the query.
          content:
            application/json:
              schema:
                type: object
                required:
                - query_id
                - results
                properties:
                  query_id:
                    type: string
                  query:
                    type: string
                  mode:
                    type: string
                  summary:
                    type: string
                  results:
                    type: array
                    items:
                      type: object
                      required:
                      - url
                      - name
                      properties:
                        url:
                          type: string
                          format: uri
                        name:
                          type: string
                        site:
                          type: string
                        score:
                          type: number
                        description:
                          type: string
                        schema_object:
                          type: object
                  _meta:
                    type: object
                    properties:
                      response_type:
                        type: string
                      version:
                        type: string
                      site:
                        type: string
        '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/search:
    get:
      operationId: searchDocs
      tags:
      - Docs
      summary: Search the documentation
      description: Case-insensitive search over every page's title, description and section. Returns the same page summaries as listDocPages, best match first.
      parameters:
      - name: q
        in: query
        required: true
        description: What to search for.
        schema:
          type: string
          minLength: 1
      - name: limit
        in: query
        required: false
        description: How many results to return.
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 10
      responses:
        '200':
          description: Matching pages.
          content:
            application/json:
              schema:
                type: object
                required:
                - query
                - count
                - results
                properties:
                  query:
                    type: string
                  count:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchResult'
        '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.
    PageSummary:
      type: object
      required:
      - slug
      - title
      - url
      - markdown_url
      - section
      properties:
        slug:
          type: string
          description: Identifier for getDocPage.
        title:
          type: string
        description:
          type: string
        section:
          type: string
          description: Documentation, Writing, or Site.
        url:
          type: string
          format: uri
          description: Canonical HTML URL.
        markdown_url:
          type: string
          format: uri
          description: 'Same page as Markdown; the HTML URL also serves it under Accept: text/markdown.'
    SearchResult:
      type: object
      required:
      - slug
      - title
      - url
      - markdown_url
      - section
      properties:
        slug:
          type: string
          description: Identifier for getDocPage.
        title:
          type: string
        description:
          type: string
        section:
          type: string
          description: Documentation, Writing, or Site.
        url:
          type: string
          format: uri
          description: Canonical HTML URL.
        markdown_url:
          type: string
          format: uri
          description: 'Same page as Markdown; the HTML URL also serves it under Accept: text/markdown.'
        snippet:
          type: string
          description: The matching line of the page, when the match was in the body rather than the title.
externalDocs:
  description: Documentation
  url: https://agent-manager.dev/docs/