> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcdn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Every public and account endpoint, with links to the live OpenAPI descriptions.

All endpoints live on `https://api.agentcdn.com`. Two live OpenAPI descriptions cover most of them. OpenAPI is a standard machine-readable format for describing an HTTP API.

| Description | URL | Auth |
| - | - | - |
| Public API | [`/public/openapi.json`](https://api.agentcdn.com/public/openapi.json) | None |
| Account API | [`/v1/openapi.json`](https://api.agentcdn.com/v1/openapi.json) | Account API key |

Load either file into your API client or code generator. They are always current.

## Public API

No key needed. Responses follow the Agent-Ready Video (ARV) standard where noted. Errors carry a 4xx status and the `PublicApiError` shape. The ARV routes and the Ask over-limit `429` use the ARV error envelope instead.

### Discovery

| Method | Path | What it does |
| - | - | - |
| GET | `/.well-known/arv` | ARV discovery manifest. |
| GET | `/.well-known/jwks.json` | Signing keys (JWKS) for receipts. |
| GET | `/.well-known/agent-card.json` | A2A agent card. A2A is an open protocol for agents to describe themselves to other agents. |
| GET | `/public/creators` | The public library registry. |

### Catalogs and videos

| Method | Path | What it does |
| - | - | - |
| GET | `/public/creators/{slug}/page-blocks/{customer_video_id}` | The page block for one video by your own id. `format=json`, `head` or `body`. No key for a listed account. An unlisted account sends its account API key. See [Put metadata on your pages](https://docs.agentcdn.com/guides/page-metadata.md). |
| GET | `/public/creators/{slug}/arv.json` | The library's ARV namespace manifest. |
| GET | `/public/creators/{slug}/arv/catalog.json` | The library's ARV 1.0 catalog. Add `?page=N` for further pages. |
| GET | `/public/arv/catalog.json` | One ARV 1.0 catalog over every public library. |
| GET | `/public/creators/{slug}/videos/{video_id}/arv.json` | The ARV record for one video. An unlisted account sends its account API key. |
| GET | `/public/creators/{slug}/llms.txt` | The library's index for language models. |

### Search and topics

| Method | Path | What it does |
| - | - | - |
| GET | `/public/creators/{slug}/ask` | Search the library in natural language. Returns moments. |
| GET | `/public/creators/{slug}/suggested-questions.json` | Suggested questions grounded in the library. |
| GET | `/public/creators/{slug}/topics.json` | The library's topic map. |
| GET | `/public/creators/{slug}/topics/{topic_id}/takes.json` | Takes on one topic. |
| GET | `/public/creators/{slug}/topics/{topic_id}/channel.json` | A topic channel. |

### Ask

`managed-ask`, `moment-agent` and `ask-widget.json` take an optional Ask key. `ask-events` takes none. See [Add Ask to your site](https://docs.agentcdn.com/guides/embed-ask.md#ask-keys).

| Method | Path | What it does |
| - | - | - |
| POST | `/public/creators/{slug}/managed-ask` | An Ask answer with its moments. The Ask box uses this route. |
| GET, POST | `/public/creators/{slug}/moment-agent` | The Moment Agent: an answer that leads to the moment. |
| GET | `/public/creators/{slug}/ask-widget.json` | The Ask box configuration. |
| POST | `/public/creators/{slug}/ask-events` | Report plays of moments an Ask answer cited, from your own player. No key and no cookies. Send the body as `text/plain` to avoid a browser preflight. |

### Usage

| Method | Path | What it does |
| - | - | - |
| POST | `/public/creators/{slug}/usage` | Report a use of a moment in one library. Returns a signed receipt. |
| POST | `/public/usage` | Report a use of a moment across the network. |

## Account API

Send an account API key as `Authorization: Bearer <key>`. Reads need `account:read`. Changes need `account:write` and run in two calls: a preview with a `confirm_token`, then the same call with the token. Up to 120 calls a minute per account. See [API keys](https://docs.agentcdn.com/api-keys.md).

Every route is listed with its tool name in [Account API and MCP tools](https://docs.agentcdn.com/reference/account-tools.md). Request schemas are in [`/v1/openapi.json`](https://api.agentcdn.com/v1/openapi.json). The main groups:

| Group | Endpoints |
| - | - |
| Account and profile | `GET /v1/account`, `GET` and `PATCH /v1/profile`, `GET` and `POST /v1/links` |
| Members and Kajabi | `GET` and `POST /v1/members`, `POST /v1/members/collections`, `POST /v1/member-libraries/{library_id}`, and the routes under `/v1/membership/kajabi`. See [Paid and member libraries](https://docs.agentcdn.com/guides/member-libraries.md). |
| Videos | `GET /v1/videos`, `GET` and `PATCH /v1/videos/{video_id}`, `GET /v1/videos/{video_id}/transcript`, `GET /v1/videos/{video_id}/timeline`, `GET /v1/videos/{video_id}/youtube-analytics`, `POST /v1/videos/{video_id}/actions`, `POST /v1/videos/{video_id}/range-link` |
| Answers | `POST /v1/ask`, `POST /v1/moments`, `GET /v1/memory` |
| Questions and reports | `GET /v1/questions`, `GET /v1/reports/ask`, `GET /v1/reports/agent-usage` |
| AI access and answers | `GET` and `PUT /v1/agent-access`, `GET` and `PATCH /v1/answer-settings`, `PUT /v1/featured-questions`, `GET` and `POST /v1/discovery` |
| Imports and catalog | `POST /v1/imports`, `GET /v1/imports/{import_id}`, `GET` and `POST /v1/catalog-source`, `POST /v1/catalog-source/imports`, `GET` and `POST /v1/sources` |
| Website | `POST /v1/website`, `POST /v1/website/{site_id}/check` |
| Keys, apps and webhooks | `GET` and `POST /v1/ask-keys`, `GET /v1/connected-apps`, `POST /v1/connected-apps/revoke`, `GET` and `POST /v1/webhooks`, `DELETE /v1/webhooks/{webhook_id}` |
| AI Video Visibility | `GET /v1/visibility`, `POST /v1/visibility/brands`, and the report, answers, refresh, question and website check routes under `/v1/visibility/brands/{brand_id}` |

The same operations are tools on the [account MCP](https://docs.agentcdn.com/guides/connect-mcp.md#account-mcp).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.