Skip to main content
Most of what you put on public pages needs no key. You need a key to read or change your own account from a script or server.

​
Calls that need no key

  • Page blocks of a listed account. GET /public/creators/{slug}/page-blocks/{your video id}. See Put metadata on your pages. An unlisted account reads its own blocks with an account API key. See Listed and unlisted accounts.
  • Public ARV records and catalogs. The /public/... routes in the public API.
  • The public MCP servers. https://mcp.agentcdn.com/c/{slug}/mcp for one library, and https://mcp.agentcdn.com/mcp for the network. See Connect an MCP.
  • The account MCP in an AI app. ChatGPT, Claude and other apps connect with a sign-in, not a key.
  • The Ask box. It works without a key, with lower limits. See Add Ask to your site.

​
Account API keys

Account API keys call the /v1 account API: your videos, transcripts, answers, reports, settings and imports.
1

Open the keys card

Sign in at app.agentcdn.com. Open Settings, then API and MCP. The API keys card is on that page.
2

Create a key

Choose Create API key. Give it a name, for example “Weekly report script”. Pick the access:
  • Read only. Reads your library, questions and reports.
  • Can make changes. Also edits videos, AI access, featured questions, imports and webhooks.
3

Copy it now

The full key shows once. Store it in your secret manager. The console keeps only the key’s prefix, so you can tell keys apart later.
Your account needs a connected video source before you can create a key. The card says so and links to Imports.
Send the key as a bearer token:

​
Scopes

​
Changes run in two calls

Most changes do not run on the first call. The first call returns a preview of what would change and a confirm_token. Send the same request again with that confirm_token to run it. A few changes that only repeat safe work run in one call. The reference says which.

​
Limits and errors

The account API allows up to 120 calls a minute per account. Errors come back as { "error": "<code>", "message": "<plain words>" }.

​
Revoke a key

Choose Revoke on the key’s row. Tools that use it stop working at once.

​
Ask keys

Ask keys are a separate kind of key. They raise the Ask limits and count Ask answers to your account. They live in the console on the Ask page screen, in the Ask keys card. See Embed Ask on your site.
Never put an account API key in a web page or a client app. Use a browser Ask key there instead.