API reference - AgentTV

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`	None
Account API	`/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.
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.

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. Every route is listed with its tool name in Account API and MCP tools. Request schemas are in /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.
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.

​Public API

​Discovery

​Catalogs and videos

​Search and topics

​Ask

​Usage

​Account API