Unlisted: read with your key
Send an account API key withaccount:read as a bearer token. The key must belong to the account in the URL.
- Call it from your server or build step only. Never put the key in a page.
- The answer is
Cache-Control: private, no-store. Keep it in your own server cache, not a shared CDN. - Without a key, or with another account’s key, the answer is the same
404as for an unknown video. - The video must be live and have its own page in your catalog. Otherwise the answer is
404. - Each key read is logged against your account.
- Nothing is added to an AgentTV sitemap, directory, watch page or catalog.
Which to pick
- Pick listed when you want the public MCP server, the Ask script and AgentTV watch pages, for example to demo playback in ChatGPT or Claude to anyone with the link.
- Pick unlisted when every public surface must stay on your own domain. Your pages carry the metadata, and your team uses the account API and account MCP.