ADadcontextprotocol
Authorization Lookups

Revalidate publisher adagents.json

Changed on

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 validator always fetches the live origin.

Rate limits: 5 minutes per domain, 30 requests per user per hour.

post/api/registry/publisher/{domain}/adagents/revalidate

Request

  • Base URL
    https://agenticadvertising.org
  • URL
    https://agenticadvertising.org/api/registry/publisher/{domain}/adagents/revalidate
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://agenticadvertising.org/authorize
      Token URL: https://agenticadvertising.org/token

Path parameters

domainstring required
Example:publisher.example

Query parameters

force'1' | 'true'

Accepted for tooling compatibility; live origin validation is always performed.

Response

Revalidation result

domainstring required
adagents_validboolean required
checked_atstring date-time required
errorstring
properties_countinteger
authorized_agents_countinteger
status_codeinteger
response_bytesinteger
resolved_urlstring
discovery_method'direct' | 'authoritative_location' | 'ads_txt_managerdomain' | 'adagents_authoritative'
manager_domainstring

Changes

  • cb485604bda3Revision changes
    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added subschema #1 subschema #2 to the response body anyOf list for the response status

  • 26dede3c65c1Revision changes
    • info

      added the non-success response with the status