Publish community mirror
Publish or update a catalog-only adagents.json community mirror. Requires a registry moderator or AgenticAdvertising.org admin. The service validates the assembled document against adagents.json, forces authorized_agents: [], regenerates $schema and last_updated, and updates derived publisher-domain catalog rows.
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
Lowercase platform identifier.
^[a-z0-9_-]{1,64}$"example_platform"
Body
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
Catalog-only adagents.json body for a community mirror. At least one of formats, properties, placements, collections, or signals must be present and non-empty. The service regenerates $schema and last_updated before persisting.
11 - 255HTTPS URL for the canonical successor adagents.json document. Set this before deleting a mirror so buyers can migrate cached references.
^https:\/\/Response
Community mirror published
true Lowercase platform identifier, normalized by the service.
^[a-z0-9_-]{1,64}$"example_platform"
HTTPS successor document URL, when this mirror has been superseded.
^https:\/\/Publisher domains updated from this community mirror catalog.