🎉 AdCP 3.0 is now GA — see what's new
Documentation
- Introduction
- Quickstart
- FAQ
- 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
- Release Notes
- Changelog
- Implementor FAQ
- Glossary
- Working Group
- Joining the Community Slack
curl --request POST \
--url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/oauth-client-credentials/test \
--header 'Authorization: Bearer <token>'{
"latency_ms": 123
}Dry-run the saved OAuth 2.0 client-credentials config
Exchange the saved client_credentials at the token endpoint and discard the resulting access token. Returns success + latency on a 2xx exchange, or the SDK’s ClientCredentialsExchangeError kind (oauth, malformed, network) on failure so operators get same-second feedback instead of waiting for the next compliance heartbeat. Requires authentication and ownership. Requires credentials to already be saved via PUT /oauth-client-credentials.
curl --request POST \
--url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/oauth-client-credentials/test \
--header 'Authorization: Bearer <token>'{
"latency_ms": 123
}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
Response
Result of the token exchange. ok: true on 2xx from the AS; ok: false with a typed error otherwise (HTTP response itself is still 200 — the error payload carries the rejection kind so UI can branch on it).
Was this page helpful?