---
title: "Publish community mirror"
method: PUT
path: "/api/registry/mirrors/{platform}"
tags: ["Community Mirrors"]
---

# Publish community mirror

`PUT /api/registry/mirrors/{platform}`

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.

## Path parameters

- `platform` string, required — Lowercase platform identifier.

## Request body

- union — 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.
  - object
    - `catalog_etag` string
    - `formats` object[], required
    - `properties` object[]
    - `placements` object[]
    - `placement_tags` object
    - `collections` object[]
    - `signals` object[]
    - `signal_tags` object
    - `contact` unknown
    - `superseded_by` string — HTTPS URL for the canonical successor adagents.json document. Set this before deleting a mirror so buyers can migrate cached references.
  - object
    - `catalog_etag` string
    - `formats` object[]
    - `properties` object[], required
    - `placements` object[]
    - `placement_tags` object
    - `collections` object[]
    - `signals` object[]
    - `signal_tags` object
    - `contact` unknown
    - `superseded_by` string — HTTPS URL for the canonical successor adagents.json document. Set this before deleting a mirror so buyers can migrate cached references.
  - object
    - `catalog_etag` string
    - `formats` object[]
    - `properties` object[]
    - `placements` object[], required
    - `placement_tags` object
    - `collections` object[]
    - `signals` object[]
    - `signal_tags` object
    - `contact` unknown
    - `superseded_by` string — HTTPS URL for the canonical successor adagents.json document. Set this before deleting a mirror so buyers can migrate cached references.
  - object
    - `catalog_etag` string
    - `formats` object[]
    - `properties` object[]
    - `placements` object[]
    - `placement_tags` object
    - `collections` object[], required
    - `signals` object[]
    - `signal_tags` object
    - `contact` unknown
    - `superseded_by` string — HTTPS URL for the canonical successor adagents.json document. Set this before deleting a mirror so buyers can migrate cached references.
  - object
    - `catalog_etag` string
    - `formats` object[]
    - `properties` object[]
    - `placements` object[]
    - `placement_tags` object
    - `collections` object[]
    - `signals` object[], required
    - `signal_tags` object
    - `contact` unknown
    - `superseded_by` string — HTTPS URL for the canonical successor adagents.json document. Set this before deleting a mirror so buyers can migrate cached references.

## Response `200`

Community mirror published

- CommunityMirrorPublishResponse
  - `success` true, required
  - `platform` string, required — Lowercase platform identifier, normalized by the service.
  - `catalog_etag` string, nullable, required
  - `superseded_by` string, nullable, required — HTTPS successor document URL, when this mirror has been superseded.
  - `publisher_domains` string[], required — Publisher domains updated from this community mirror catalog.
  - `updated_at` string, date-time, required

## Other responses

- `400` — Invalid platform, request body, or adagents.json conformance failure
- `401` — Authentication required
- `403` — Only registry moderators or AgenticAdvertising.org admins can manage community mirrors
- `429` — Rate limit exceeded
- `500` — Failed to publish community mirror

---

[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)