Agent Discovery

Request domain re-crawl

Changed on

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.

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

post/api/registry/crawl-request

Request

  • Base URL
    https://agenticadvertising.org
  • URL
    https://agenticadvertising.org/api/registry/crawl-request
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://agenticadvertising.org/authorize
      Token URL: https://agenticadvertising.org/token

Request body

domainstring required

Publisher domain to re-crawl

Example request

{
  "domain": "examplepub.com"
}

Response

Crawl request accepted

message'Crawl request accepted' required
domainstring required
crawl_request_idstring uuid required

Durable request ID for lifecycle logs and status lookup; acceptance is not completion.

Changes

    • warning

      added the new crawl_queue_at_capacity enum value to the response property for the response status

    • warning

      added the new crawl_queue_unavailable enum value to the response property for the response status

    • info

      removed the crawl_temporarily_unavailable enum value from the response property for the response status

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status