# AdCP - Ad Context Protocol > AdCP (Ad Context Protocol) is the open standard for agentic advertising. It defines how AI agents buy media, generate creatives, activate audiences, and enforce governance across platforms. ## Docs - [API discovery](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/search/api-discovery.md): Returns links to the main API entry points and documentation. - [Search](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/search/search.md): Search across brands, publishers, and properties. Returns up to 5 results per category. - [Manifest reference lookup](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/search/manifest-reference-lookup.md): Find the best manifest reference (brand.json URL or agent) for a domain. - [Resolve brand](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/resolve-brand.md): Resolve a domain to its canonical brand identity. Follows brand.json redirects and returns the resolved brand with its house, architecture type, and optional manifest. The domain must be a bare DNS hostname. - [Bulk resolve brands](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/bulk-resolve-brands.md): Resolve up to 25 domains to their canonical brand identities in a single request. Unresolvable domains map to `null`. - [Get brand.json](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/get-brandjson.md): Fetch the raw brand.json file for a bare DNS hostname. - [Save brand](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/save-brand.md): Save or update a brand in the registry. Requires authentication. For existing brands, creates a revision-tracked edit. For new brands, creates the brand directly. Cannot edit authoritative brands managed via brand.json. - [List brands](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/list-brands.md): List all brands in the registry with optional search, pagination, and source filter. - [Brand activity history](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/brand-activity-history.md): Returns the edit history for a brand in the registry, newest first. Only brands with community or enriched edits have history; brand.json-sourced brands are authoritative and do not generate revisions. - [Enrich brand](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/enrich-brand.md): Enrich brand data using Brandfetch. Returns logo, colors, and company information. Authenticated callers may also receive ephemeral Brand Context API identity/positioning/voice data. - [Find brands by name](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/find-brands-by-name.md): Search for brands by name or domain. Returns matching results with basic identity info. - [Set up a hosted brand.json](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-resolution/set-up-a-hosted-brandjson.md): Create or update a hosted brand.json for a domain owned by the authenticated user's organization. Returns the hosted URL and a pointer snippet for DNS setup. - [Property activity history](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/property-activity-history.md): Returns the edit history for a property in the registry, newest first. - [Resolve property](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/resolve-property.md): Resolve a publisher domain to its property information. Checks hosted properties, discovered properties, then live adagents.json validation. - [Bulk resolve properties](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/bulk-resolve-properties.md): Resolve up to 100 publisher domains at once. - [List properties](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/list-properties.md): List all properties in the registry with optional search, pagination. - [Validate adagents.json](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/validate-adagentsjson.md): Validate a domain's adagents.json file and return the validation result. - [Save property](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/save-property.md): Save or update a hosted property in the registry. Requires authentication. For existing properties, creates a revision-tracked edit. For new properties, creates the property directly. Cannot edit authoritative properties managed via adagents.json. - [Claim a domain for bind-on-verify](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/claim-a-domain-for-bind-on-verify.md): Issue a pending domain claim for the caller's organization and return a claim-specific `authoritative_location` URL (`…/adagents.json?adcp_claim=`). The caller places that single pointer at their own origin `/.well-known/adagents.json`; a subsequent verify-origin reads the token and binds the… - [Verify AAO-hosted publisher origin](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/verify-aao-hosted-publisher-origin.md): Trigger origin verification for an AAO-hosted publisher: fetches the publisher's own `/.well-known/adagents.json` and checks for an `authoritative_location` field pointing at the AAO-hosted URL. On success, promotes `agent_publisher_authorizations` rows from `source='aao_hosted'` to `source='adagent… - [Check property list](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/check-property-list.md): Check a list of publisher domains against the AAO registry. Normalizes domains (strips www/m prefixes), removes duplicates, flags known ad tech infrastructure, and identifies domains not yet in the registry. - [Get property check report](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/get-property-check-report.md): Retrieve a previously stored property check report by ID. Reports expire after 7 days. - [Bulk property identifier check](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/bulk-property-identifier-check.md): Check up to 10,000 property identifiers (domains, app bundle IDs, CTV store URLs) against the registry catalog. Returns a verdict for each identifier and a summary. - [Get bulk check report](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-resolution/get-bulk-check-report.md): Retrieve a previously generated bulk property check report by ID. - [List agents](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-discovery/list-agents.md): List all agents in the registry. Optionally enrich with health checks, capabilities, and property summaries via query parameters. Measurement-vendor filters (`metric_id`, `accreditation`, `q`) imply `type=measurement`. Canonical creative-capability filters (`format_kind`, `publisher_domain`, `format… - [List publishers](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-discovery/list-publishers.md): List all registered publishers. - [Registry statistics](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-discovery/registry-statistics.md): Get aggregate statistics about the registry. - [Search agent inventory profiles](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-discovery/search-agent-inventory-profiles.md): Search agents by inventory profile — channels, markets, content categories, property types, and more. Filters use AND across dimensions and OR within a dimension. Results are ranked by relevance score. - [Request domain re-crawl](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-discovery/request-domain-re-crawl.md): Persist a durable re-crawl request for a publisher domain after updating adagents.json. Returns 202 only after the request is committed to the queue. Use the returned `crawl_request_id` with the status endpoint to observe completion. - [Get publisher crawl request status](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-discovery/get-publisher-crawl-request-status.md): Return the durable lifecycle for a publisher recrawl. Requesters may read their own requests; registry administrators may read any request. - [Request manager fan-out re-validation](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-discovery/request-manager-fan-out-re-validation.md): Trigger re-validation of every publisher delegating to a manager domain via ads.txt `MANAGERDOMAIN`. Use after rotating the manager's `adagents.json` so the change propagates to delegating publishers without waiting for the next routine crawl cycle. Work is queued and drained at a bounded rate (≈50… - [Domain lookup (deprecated)](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/domain-lookup-deprecated.md): **Deprecated.** Use `/api/registry/publisher?domain=X` for richer data including hosting state, per-agent rollup, and brand.json fallback. This endpoint will be removed in a future release. - [Property identifier lookup](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/property-identifier-lookup.md): Find agents that hold a specific property identifier. - [Agent domain lookup](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/agent-domain-lookup.md): Get all publisher domains associated with an agent. - [AAO directory inverse-lookup](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/aao-directory-inverse-lookup.md): Given a percent-encoded `agent_url`, returns the publishers whose adagents.json authorizes that agent, with provenance (`discovery_method`, `manager_domain`), per-publisher property counts (`properties_authorized`, `properties_total`, scoped to this publisher only — never network-wide), signing-key… - [AAO directory inverse-lookup](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/aao-directory-inverse-lookup-1.md): Given a percent-encoded `agent_url`, returns the publishers whose adagents.json authorizes that agent, with provenance (`discovery_method`, `manager_domain`), per-publisher property counts (`properties_authorized`, `properties_total`, scoped to this publisher only — never network-wide), signing-key… - [Operator lookup](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/operator-lookup.md): Given a domain, returns the agents this entity operates and which publishers trust them. - [Publisher lookup](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/publisher-lookup.md): Given a domain, returns the inventory this entity publishes and which agents it authorizes. - [Revalidate publisher adagents.json](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/revalidate-publisher-adagentsjson.md): Admin-only endpoint for support/operator tooling to synchronously fetch a publisher's live `/.well-known/adagents.json`, run the registry validator, persist the refreshed verdict and fetch metadata, and return the validation result. `force=true` is accepted for operator tooling; the current validato… - [Per-agent authorization rollup](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/per-agent-authorization-rollup.md): Returns whether a given agent is authorized for a publisher domain and how many of the publisher's properties it can sell. When the agent has property-level authorization rows, the count is the intersection with the publisher's property set; when it only has a publisher-wide row, the count equals th… - [Validate product authorization](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/validate-product-authorization.md): Check whether an agent is authorized to sell a product based on its publisher_properties. - [Expand product identifiers](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/expand-product-identifiers.md): Expand publisher_properties selectors into concrete property identifiers for caching. - [Property authorization check](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/authorization-lookups/property-authorization-check.md): Quick check if a property identifier is authorized for an agent. Optimized for real-time ad request validation. - [Force a synchronous brand.json crawl](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-discovery/force-a-synchronous-brandjson-crawl.md): Admin-only support endpoint that fetches a domain's live `/.well-known/brand.json`, persists valid origin evidence, and returns the before/after state. A verified owner remains labeled `source: hosted` because that field describes identity provenance; `new_source_type: brand_json` and `promoted: tru… - [Request brand.json re-crawl](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/brand-discovery/request-brandjson-re-crawl.md): Trigger an immediate re-crawl of a domain's brand.json. The crawl runs asynchronously — returns 202 immediately. - [Validate adagents.json](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/validation-tools/validate-adagentsjson.md): Validate a domain's adagents.json file and optionally validate referenced agent cards. - [Generate adagents.json](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/validation-tools/generate-adagentsjson.md): Generate a valid adagents.json file from authorized agents and/or catalog content. `authorized_agents` may be empty for a catalog-only community mirror that publishes formats/properties/placements for a platform that has not adopted AdCP. - [List community mirror proposals](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/community-mirrors/list-community-mirror-proposals.md): List the caller's own community-mirror proposals. Registry moderators and AgenticAdvertising.org administrators see the review queue and may filter by status; their default is `pending`. - [Get community mirror proposal](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/community-mirrors/get-community-mirror-proposal.md): Fetch a proposal owned by the caller. Registry moderators and AgenticAdvertising.org administrators may fetch any proposal. - [Approve community mirror proposal](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/community-mirrors/approve-community-mirror-proposal.md): Approve and atomically publish a pending proposal. Requires a registry moderator or AgenticAdvertising.org administrator. - [Reject community mirror proposal](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/community-mirrors/reject-community-mirror-proposal.md): Reject a pending proposal with reviewer notes. Requires a registry moderator or AgenticAdvertising.org administrator. - [List community mirrors](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/community-mirrors/list-community-mirrors.md): List persisted catalog-only adagents.json community mirrors. The list projection includes presence and freshness metadata but omits the full `adagents_json` body; fetch a platform-specific mirror for the full document. - [Get community mirror](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/community-mirrors/get-community-mirror.md): Fetch one persisted community mirror by platform. A present mirror returns the platform metadata plus the stored catalog-only `adagents_json` document; absent mirrors return 404. - [Publish or propose community mirror](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/community-mirrors/publish-or-propose-community-mirror.md): Submit a catalog-only adagents.json community mirror. Registry moderators and AgenticAdvertising.org administrators publish immediately; other authenticated organization callers create or refresh a pending proposal and receive HTTP 202. Contributor proposals are limited to 1 MiB and 2,000 catalog it… - [Delete community mirror](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/community-mirrors/delete-community-mirror.md): Delete a persisted community mirror and retire derived publisher-domain catalog rows. Requires a registry moderator or AgenticAdvertising.org admin. Without `force=true`, the service refuses to delete a mirror that has not first published a `superseded_by` migration URL. - [Discover agent](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-probing/discover-agent.md): Probe an agent URL to discover its name, type, supported protocols, and basic statistics. - [Get creative-agent format capabilities](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-probing/get-creative-agent-format-capabilities.md): Fetch get_adcp_capabilities creative.supported_formats[] from a creative agent, falling back to the deprecated list_creative_formats catalog for 3.1-compatible agents. - [Get agent publisher properties](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-probing/get-agent-publisher-properties.md): Fetch public list_authorized_properties data from a sales agent. - [Get agent products](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-probing/get-agent-products.md): Fetch products from a sales agent. - [Validate publisher](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-probing/validate-publisher.md): Validate a publisher domain's adagents.json and return summary statistics. - [List policies](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/policy-registry/list-policies.md): Browse and search the governance policy registry. Returns approved policies with optional filtering by category, enforcement level, jurisdiction, policy category, and governance domain. - [Resolve policy](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/policy-registry/resolve-policy.md): Resolve a single policy by ID. Optionally pin to a specific version — returns null if the version does not match. - [Bulk resolve policies](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/policy-registry/bulk-resolve-policies.md): Resolve up to 100 policies by ID in a single request. Returns a map of policy_id to Policy (or null if not found). - [Policy revision history](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/policy-registry/policy-revision-history.md): Retrieve the edit history for a policy. Each revision records who made the change, a summary, and whether it was a rollback. - [Save policy](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/policy-registry/save-policy.md): Create or update a community-contributed policy. Requires authentication. Registry-sourced and pending-review policies cannot be edited (returns 409). Updates automatically create a revision record. - [Registry change feed](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/change-feed/registry-change-feed.md): Poll a cursor-based feed of registry changes. Events are ordered by UUID v7 event_id for monotonic cursor progression. The feed retains events for 90 days. The `freshness` object reports when the response was generated, the newest matching event currently visible to the feed, and the resulting feed… - [Registry change feed stream](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/change-feed/registry-change-feed-stream.md): Subscribe to registry feed pages over Server-Sent Events. This is a push-friendly transport for the same cursor contract as `/api/registry/feed`: clients still persist `cursor`, apply only feed events, and recover from `cursor_expired` by re-bootstrapping. The stream emits `feed` events containing a… - [Per-agent authorization pull](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/change-feed/per-agent-authorization-pull.md): Default endpoint for verification consumers (DSPs, sales houses, agencies). Returns the rows where the requested agent appears as `agent_url` — typically ≤ a few hundred. Pair with `/api/registry/feed?entity_type=authorization` to tail subsequent changes via the `X-Sync-Cursor` header. - [Bootstrap snapshot for inline verifiers](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/change-feed/bootstrap-snapshot-for-inline-verifiers.md): Streams the full effective authorization set as gzipped NDJSON (one JSON object per line). Consumers persist `X-Sync-Cursor` and tail `/api/registry/feed?entity_type=authorization&cursor=` for deltas. - [Get agent compliance detail](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-agent-compliance-detail.md): Returns detailed compliance status for a single agent, including track-level results, storyboard counts, and timestamps. - [AAO public key set](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/aao-public-key-set.md): Returns the JSON Web Key Set (JWKS) containing AAO's public verification keys. Use these to verify AAO Verified badge tokens without calling AAO's API. - [Get agent AAO Verified status](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-agent-aao-verified-status.md): Returns AAO Verified badge status for a single agent. Public and cacheable. Includes role badges, verified storyboards, and a link to the agent's registry listing. - [Get agent verification badge SVG](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-agent-verification-badge-svg.md): Returns an SVG badge image for the specified agent and role. Shows the role-specific AgenticAdvertising.org Verified mark (teal) when verified, or 'Not Verified' (grey) when not. Cacheable and suitable for embedding in websites. - [Get embeddable badge code](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-embeddable-badge-code.md): Returns HTML and Markdown embed snippets for displaying an AAO Verified badge on websites, social profiles, and documentation. The badge links to the agent's AAO registry listing. - [Get version-pinned agent verification badge SVG](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-version-pinned-agent-verification-badge-svg.md): Returns an SVG badge image scoped to a specific AdCP release (MAJOR.MINOR, e.g. '3.0'). Buyers who want to call out 'verified for 3.0' embed this instead of the legacy `/badge/{role}.svg` (which auto-upgrades to the highest active version). Renders 'Not Verified' when the agent never earned a badge… - [Get version-pinned embeddable badge code](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-version-pinned-embeddable-badge-code.md): Returns HTML and Markdown embed snippets that point at the version-pinned SVG. Alt text includes the version (e.g. 'AAO Verified Media Buy Agent 3.0'). Buyers who want to freeze on a specific AdCP release embed these instead of the legacy `/badge/{role}/embed`. - [Get agent storyboard status](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-agent-storyboard-status.md): Returns per-storyboard test results for an agent. Includes title, category, track, pass/fail status, and step counts. - [Bulk storyboard status](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/bulk-storyboard-status.md): Returns per-storyboard test results for multiple agents in a single request. - [Get agent compliance history](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-agent-compliance-history.md): Returns a list of compliance test runs for an agent, ordered most recent first. - [Update agent lifecycle stage](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/update-agent-lifecycle-stage.md): Set the lifecycle stage for an agent. Requires authentication and ownership of the agent. - [Update compliance opt-out](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/update-compliance-opt-out.md): Opt an agent in or out of public compliance reporting. Requires authentication and ownership of the agent. - [Get monitoring settings](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-monitoring-settings.md): Returns the monitoring configuration for an agent. Requires authentication and ownership. - [Pause or resume monitoring](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/pause-or-resume-monitoring.md): Pause or resume automated compliance monitoring for an agent. Requires authentication and ownership. - [Update monitoring interval](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/update-monitoring-interval.md): Set the check interval for automated compliance monitoring (6–168 hours). Requires authentication and ownership. - [Requeue agent for compliance heartbeat](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/requeue-agent-for-compliance-heartbeat.md): Clears the agent's last_checked_at timestamp so it is picked up on the next heartbeat cycle (within ~1 hour). This is queued-async; it does not run the compliance suite synchronously or change the current verdict until the heartbeat completes. Requires authentication and ownership. - [Get per-step diagnostics for a compliance run](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-per-step-diagnostics-for-a-compliance-run.md): Returns the exact request and response payloads the runner captured for failing storyboard steps on a single compliance run. - [Get outbound request log](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-outbound-request-log.md): Returns the outbound request log for an agent (compliance checks, health probes, etc.). Requires authentication and ownership, or the static admin API key for support/debugging. - [Refresh agent snapshot](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/refresh-agent-snapshot.md): Re-probe the agent and update its registry health (online, tools_count, response_time_ms), capability snapshot (inferred type, discovered tools), and compliance verdict (storyboard pass/fail counts). Use after fixing your agent so the registry shows fresh data without waiting for the periodic heartb… - [Get agent auth status](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-agent-auth-status.md): Returns whether an agent has stored authentication credentials and OAuth token status. Requires authentication. - [Connect agent credentials](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/connect-agent-credentials.md): Store authentication credentials for an agent. Requires authentication and ownership. - [Save OAuth 2.0 client-credentials for an agent](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/save-oauth-20-client-credentials-for-an-agent.md): Store a machine-to-machine OAuth 2.0 client-credentials configuration (RFC 6749 §4.4) for this agent. The SDK exchanges at the token endpoint before every call and refreshes on 401. `client_secret` may be a `$ENV:VAR_NAME` reference — the SDK resolves at exchange time, the server stores it as writte… - [Dry-run the saved OAuth 2.0 client-credentials config](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/dry-run-the-saved-oauth-20-client-credentials-config.md): 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 fo… - [Get applicable storyboards for agent](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-applicable-storyboards-for-agent.md): Probe the agent's get_adcp_capabilities and resolve its declared supported_protocols and specialisms to the compliance bundles that will run. Requires authentication and ownership. - [List storyboards](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/list-storyboards.md): Returns the catalog of compliance storyboards. Optionally filter by category. - [Get storyboard detail](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-storyboard-detail.md): Returns a single storyboard with its full phase and step structure, plus its test kit if available. - [Run a single storyboard step](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/run-a-single-storyboard-step.md): Execute a single storyboard step against an agent. Requires authentication and ownership. - [Get first step preview](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/get-first-step-preview.md): Returns a preview of the first step of a storyboard. No agent call needed. - [Run full storyboard evaluation](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/run-full-storyboard-evaluation.md): Execute all steps of a storyboard against an agent and record the compliance result. Requires authentication and ownership. - [Compare storyboard against reference agent](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/agent-compliance/compare-storyboard-against-reference-agent.md): Run a storyboard against both the target agent and the public reference agent, returning side-by-side results. Requires authentication and ownership. - [List my registered agents](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/member-agents/list-my-registered-agents.md): List the agents registered on the caller's organization member profile. Returns the same `agents[]` array stored on the profile, in the order members registered them. - [Register an agent](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/member-agents/register-an-agent.md): Register an agent on the caller's organization member profile. - [Remove an agent](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/member-agents/remove-an-agent.md): Remove one registered agent identified by its `url`. - [Update an agent](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/member-agents/update-an-agent.md): Update one registered agent identified by its `url`. The `url` field itself cannot be changed via PATCH — supplying a `url` in the body that differs from the path returns `400 url_immutable`; re-register at the new URL and DELETE the old entry to migrate. All other fields accept partial updates. - [Create or adopt my organization](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/onboarding/create-or-adopt-my-organization.md): Bootstrap the caller's organization explicitly. Use this when the caller wants to control the organization name, `company_type`, `revenue_tier`, or `is_personal` flag before any agents are registered. - [Resolve identifiers to property_rids (and contribute them)](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-catalog/resolve-identifiers-to-property_rids-and-contribute-them.md): The primary fact-contribution path. Takes identifiers plus a provenance envelope and returns stable `property_rid`s. In `resolve` mode (default) it auto-creates missing catalog entries and logs demand activity — so resolving your own identifier list IS the contribution. `property_rid` is a non-autho… - [Dispute a catalog fact](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-catalog/dispute-a-catalog-fact.md): Challenge or correct a catalog claim — the community disavow/challenge verb. Adding links is hard; suspending suspicious ones is easy: a disputed medium/weak link is suspended immediately (`action_taken: 'link_suspended'`); stronger claims queue for review. Poll status with getCatalogDispute. - [Get a catalog dispute](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-catalog/get-a-catalog-dispute.md): Fetch the current state of a filed dispute by id. - [Browse the property catalog](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-catalog/browse-the-property-catalog.md): Browse the property fact-graph with filters. Cursor-paginated (opaque `cursor` → `next_cursor`). Each entry carries the property's identifiers. `property_rid` is a non-authoritative join/match handle, never an authorization credential. - [Sync catalog changes since a watermark](https://agenticadvertisingorg-changeset-release-main.mintlify.site/docs/registry/api-reference/property-catalog/sync-catalog-changes-since-a-watermark.md): Delta sync for local mirrors: returns catalog entries created/updated since `since` (a prior `server_timestamp`), capped at 10,000 per page. Pagination is by the returned `server_timestamp` watermark, distinct from browseCatalog's opaque cursor. ## OpenAPI Specs - [registry](https://agenticadvertising.org/openapi/registry.yaml)