---
title: "Revalidate publisher adagents.json"
method: POST
path: "/api/registry/publisher/{domain}/adagents/revalidate"
tags: ["Authorization Lookups"]
---

# Revalidate publisher adagents.json

`POST /api/registry/publisher/{domain}/adagents/revalidate`

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.

## Path parameters

- `domain` string, required

## Query parameters

- `force` '1' | 'true' — Accepted for tooling compatibility; live origin validation is always performed.

## Response `200`

Revalidation result

- object
  - `domain` string, required
  - `adagents_valid` boolean, required
  - `checked_at` string, date-time, required
  - `error` string
  - `issues` object
    - `errors` object[], required
      - `field` string, required
      - `message` string, required
      - `severity` 'error', required
    - `warnings` object[], required
      - `field` string, required
      - `message` string, required
      - `suggestion` string
  - `properties_count` integer
  - `authorized_agents_count` integer
  - `status_code` integer
  - `response_bytes` integer
  - `resolved_url` string
  - `discovery_method` 'direct' | 'authoritative_location' | 'ads_txt_managerdomain' | 'adagents_authoritative'
  - `manager_domain` string

## Other responses

- `400` — Invalid domain format, private IP, or unresolvable domain
- `401` — Authentication required
- `403` — Admin access required
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) · [All operations](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adcontextprotocol/agenticadvertising-org-registry-api/revisions/9ea7fedf54c0/schema)