🎉 AdCP 3.0 is now GA — see what's new
Documentation
- Introduction
- Quickstart
- FAQ
- AI Disclosure
- Trust & Security
- Overview
- Registering an agent
- GETGet agent compliance detail
- GETAAO public key set
- GETGet agent AAO Verified status
- GETGet agent verification badge SVG
- GETGet embeddable badge code
- GETGet version-pinned agent verification badge SVG
- GETGet version-pinned embeddable badge code
- GETGet agent storyboard status
- POSTBulk storyboard status
- GETGet agent compliance history
- PUTUpdate agent lifecycle stage
- PUTUpdate compliance opt-out
- GETGet monitoring settings
- PUTPause or resume monitoring
- PUTUpdate monitoring interval
- POSTRequeue agent for compliance heartbeat
- GETGet outbound request log
- POSTRefresh agent snapshot
- GETGet agent auth status
- PUTConnect agent credentials
- PUTSave OAuth 2.0 client-credentials for an agent
- POSTDry-run the saved OAuth 2.0 client-credentials config
- GETGet applicable storyboards for agent
- GETList storyboards
- GETGet storyboard detail
- POSTRun a single storyboard step
- GETGet first step preview
- POSTRun full storyboard evaluation
- POSTCompare storyboard against reference agent
- GMSF Reference
- Media Channel Taxonomy
- Measurement Taxonomy
- Roadmap
- Versions
- Versioning & Governance
- Specification lifecycle
- URL Canonicalization
- Verifying protocol tarballs
- Reference test vectors
- Experimental status
- Schema Extensions
- v2 sunset
- Known Limitations
- Privacy Considerations
- Release Notes
- Changelog
- Implementor FAQ
- Glossary
- Working Group
- Joining the Community Slack
curl --request POST \
--url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/refresh \
--header 'Authorization: Bearer <token>'{
"online": true,
"tools_count": 123,
"response_time_ms": 123,
"inferred_type": "<string>",
"type_promoted": true,
"oauth_required": true,
"checked_at": "<string>",
"error": "<string>"
}Refresh agent snapshot
Re-probe the agent and update its registry health (online, tools_count, response_time_ms) and capability snapshot (inferred type, discovered tools). Use after fixing your agent so the registry shows fresh data without waiting for the periodic crawl.
Auth: owner of the agent or AAO admin.
Rate limits: 60 seconds per agent URL, 30 requests per user per hour.
curl --request POST \
--url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/refresh \
--header 'Authorization: Bearer <token>'{
"online": true,
"tools_count": 123,
"response_time_ms": 123,
"inferred_type": "<string>",
"type_promoted": true,
"oauth_required": true,
"checked_at": "<string>",
"error": "<string>"
}Documentation Index
Fetch the complete documentation index at: https://docs.adcontextprotocol.org/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer token in the Authorization header. Two token types are accepted:
- Organization API key (
sk_...) issued via the dashboard. Org-scoped, long-lived, for server-to-server use. - User JWT obtained via the OAuth 2.1 authorization code flow with PKCE. User-scoped, short-lived. Discover the authorization server at
/.well-known/oauth-authorization-serverand the protected-resource metadata at/.well-known/oauth-protected-resource/api.
Path Parameters
URL-encoded agent URL
"https%3A%2F%2Fvastlint.org%2Fmcp"
Response
Snapshot refreshed
Type inferred from discovered tools (sales, creative, signals, governance, etc.) or 'unknown'
True when registry type was upgraded from unknown to inferred_type
Was this page helpful?