agent-manager-dev Docs API
The documentation, as data and as Markdown.
Operations 4
2 of 4 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file
The documentation, as data and as Markdown.
2 of 4 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/agent-manager-dev:agent-manager-dev-docs-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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.
A second provider on the same verified email joins the account you already have.
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/