> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adcontextprotocol.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Reject community mirror proposal

> Reject a pending proposal with reviewer notes. Requires a registry moderator or AgenticAdvertising.org administrator.



## OpenAPI

````yaml https://agenticadvertising.org/openapi/registry.yaml post /api/registry/mirror-proposals/{id}/reject
openapi: 3.1.0
info:
  title: AgenticAdvertising.org Registry API
  description: >-
    REST API for the AgenticAdvertising.org registry. Resolve brands,

    discover properties, look up agents, and validate authorization in the

    AdCP ecosystem.


    Most endpoints are public and require no authentication. Endpoints marked

    with a lock icon accept either an organization API key or a user JWT

    obtained via the OAuth 2.1 flow — see
    [Authentication](https://agenticadvertising.org/docs/registry/index#authentication).


    **Base URL:** `https://agenticadvertising.org`
  version: 1.0.0
  contact:
    name: AgenticAdvertising.org
    url: https://agenticadvertising.org
servers:
  - url: https://agenticadvertising.org
    description: Production
security: []
tags:
  - name: Onboarding
    description: >-
      Explicitly bootstrap a third-party integration into the AAO registry. Most
      callers don't need this tag — `POST /api/me/agents` auto-creates the org
      (for fresh users) and the member profile (for first-time agent
      registration) without a separate round trip. Use `POST /api/organizations`
      only when you need to override the auto-derived org name / company_type /
      revenue_tier. Tier transitions happen via the billing flow only; the
      Stripe webhook is the sole writer of `organizations.membership_tier`.
  - name: Member Agents
    description: >-
      Register, list, update, and remove agents on the caller's organization
      member profile. Authenticated programmatic surface for CI / scripts that
      don't want to round-trip the full member profile.
  - name: Brand Resolution
    description: Resolve advertiser domains to canonical brand identities.
  - name: Property Resolution
    description: >-
      Resolve publisher domains to their property configurations and authorized
      agents.
  - name: Agent Discovery
    description: >-
      Browse the federated agent network, search agent inventory profiles,
      publisher index, and registry statistics.
  - name: Change Feed
    description: Poll cursor-based registry change events for local sync.
  - name: Lookups & Authorization
    description: >-
      Look up agents by domain or property, and validate ad-serving
      authorization.
  - name: Validation Tools
    description: >-
      Validate publisher adagents.json files and generate compliant
      configurations.
  - name: Community Mirrors
    description: >-
      Propose, review, publish, fetch, list, and retire catalog-only
      adagents.json mirrors for platforms that have not adopted AdCP.
  - name: Search
    description: Cross-entity search across brands, publishers, agents, and properties.
  - name: Agent Probing
    description: >-
      Connect to live agents and inspect their capabilities, formats, and
      inventory.
  - name: Brand Discovery
    description: Discover and crawl brand.json files across domains.
  - name: Agent Compliance
    description: Agent compliance status, storyboard test results, and compliance history.
  - name: Policy Registry
    description: >-
      Browse, resolve, and contribute governance policies for campaign
      compliance.
  - name: Property Catalog
    description: >-
      Contribute facts to the property fact-graph: resolve identifiers to stable
      property_rids (which also contributes them, with provenance) and dispute
      catalog claims.
paths:
  /api/registry/mirror-proposals/{id}/reject:
    post:
      tags:
        - Community Mirrors
      summary: Reject community mirror proposal
      description: >-
        Reject a pending proposal with reviewer notes. Requires a registry
        moderator or AgenticAdvertising.org administrator.
      operationId: rejectCommunityMirrorProposal
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: id
          in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CommunityMirrorProposalRejectRequest'
      responses:
        '200':
          description: Proposal rejected
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunityMirrorProposalDecisionResponse'
        '400':
          description: Invalid identifier or review body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunityMirrorPublishError'
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Reviewer role required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Proposal not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Proposal changed after review or was already reviewed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitError'
        '500':
          description: Failed to reject proposal
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
        - oauth2: []
components:
  schemas:
    CommunityMirrorProposalRejectRequest:
      type: object
      properties:
        proposal_digest:
          type: string
          pattern: ^[a-f0-9]{64}$
          description: >-
            SHA-256 digest that reviewers must echo when approving or rejecting
            this exact revision.
        review_notes:
          type: string
          minLength: 1
          maxLength: 2000
      required:
        - proposal_digest
        - review_notes
    CommunityMirrorProposalDecisionResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        proposal:
          $ref: '#/components/schemas/CommunityMirrorProposal'
      required:
        - success
        - proposal
    CommunityMirrorPublishError:
      type: object
      properties:
        error:
          type: string
        details:
          type: array
          items: {}
          description: >-
            Validation details for request-body parse failures or adagents.json
            conformance errors.
      required:
        - error
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
    RateLimitError:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        retryAfter:
          type: integer
          description: Seconds to wait before retrying.
      required:
        - error
    CommunityMirrorProposal:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Opaque identifier for the proposal.
          example: 4ec8bc86-6180-4d0e-aa72-9cbf402d3638
        platform:
          type: string
          pattern: ^[a-z0-9_-]{1,64}$
          description: Lowercase platform identifier, normalized by the service.
          example: example_platform
        adagents_json:
          $ref: '#/components/schemas/CommunityMirrorAdagentsJson'
        catalog_etag:
          type:
            - string
            - 'null'
        superseded_by:
          type:
            - string
            - 'null'
          pattern: ^https:\/\/
          description: HTTPS URL.
        proposal_digest:
          type: string
          pattern: ^[a-f0-9]{64}$
          description: >-
            SHA-256 digest that reviewers must echo when approving or rejecting
            this exact revision.
        base_mirror_digest:
          type:
            - string
            - 'null'
          pattern: ^[a-f0-9]{64}$
          description: >-
            Digest of the public mirror state this proposal was reviewed
            against, or null when none existed.
        status:
          type: string
          enum:
            - pending
            - approved
            - rejected
        proposed_by_organization_id:
          type:
            - string
            - 'null'
        proposed_by_email:
          type:
            - string
            - 'null'
          format: email
          description: >-
            Contributor email, returned only to registry moderators and
            AgenticAdvertising.org administrators.
        proposed_at:
          type: string
          format: date-time
        reviewed_at:
          type:
            - string
            - 'null'
          format: date-time
        review_notes:
          type:
            - string
            - 'null'
        published_at:
          type:
            - string
            - 'null'
          format: date-time
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - platform
        - adagents_json
        - catalog_etag
        - superseded_by
        - proposal_digest
        - base_mirror_digest
        - status
        - proposed_by_organization_id
        - proposed_at
        - reviewed_at
        - review_notes
        - published_at
        - created_at
        - updated_at
    CommunityMirrorAdagentsJson:
      type: object
      properties:
        $schema:
          type: string
          format: uri
        authorized_agents:
          type: array
          items:
            $ref: '#/components/schemas/AdagentsAuthorizedAgent'
          maxItems: 0
          description: >-
            Always empty for community mirrors; these catalogs never assert
            sales authorization.
        properties:
          type: array
          items:
            type: object
            additionalProperties: {}
            description: >-
              Protocol-defined catalog object. See the adagents.json JSON Schema
              for the authoritative nested shape.
        catalog_etag:
          type: string
        formats:
          type: array
          items:
            type: object
            additionalProperties: {}
            description: >-
              Protocol-defined catalog object. See the adagents.json JSON Schema
              for the authoritative nested shape.
        placements:
          type: array
          items:
            type: object
            additionalProperties: {}
            description: >-
              Protocol-defined catalog object. See the adagents.json JSON Schema
              for the authoritative nested shape.
        placement_tags:
          type: object
          additionalProperties: {}
        collections:
          type: array
          items:
            type: object
            additionalProperties: {}
            description: >-
              Protocol-defined catalog object. See the adagents.json JSON Schema
              for the authoritative nested shape.
        signals:
          type: array
          items:
            type: object
            additionalProperties: {}
            description: >-
              Protocol-defined catalog object. See the adagents.json JSON Schema
              for the authoritative nested shape.
        signal_tags:
          type: object
          additionalProperties: {}
        contact: {}
        superseded_by:
          type: string
          pattern: ^https:\/\/
          description: >-
            HTTPS URL for the canonical successor adagents.json document.
            Clients should re-fetch the successor and update cached mirror
            references before retiring use of this mirror.
        last_updated:
          type: string
          format: date-time
      required:
        - authorized_agents
      additionalProperties: {}
    AdagentsAuthorizedAgent:
      type: object
      properties:
        url:
          type: string
          format: uri
          description: Agent endpoint URL.
        authorized_for:
          type: string
        authorization_type:
          type: string
          enum:
            - property_ids
            - property_tags
            - inline_properties
            - publisher_properties
            - signal_ids
            - signal_tags
        property_ids:
          type: array
          items:
            type: string
        property_tags:
          type: array
          items:
            type: string
        properties:
          type: array
          items:
            type: object
            additionalProperties: {}
            description: >-
              Protocol-defined catalog object. See the adagents.json JSON Schema
              for the authoritative nested shape.
        publisher_properties:
          type: array
          items:
            type: object
            properties:
              publisher_domain:
                type: string
              publisher_domains:
                type: array
                items:
                  type: string
              selection_type:
                type: string
                enum:
                  - all
                  - by_id
                  - by_tag
              property_ids:
                type: array
                items:
                  type: string
              property_tags:
                type: array
                items:
                  type: string
            required:
              - selection_type
        collections:
          type: array
          items:
            type: object
            properties:
              publisher_domain:
                type: string
              collection_ids:
                type: array
                items:
                  type: string
            required:
              - publisher_domain
              - collection_ids
        placement_ids:
          type: array
          items:
            type: string
        placement_tags:
          type: array
          items:
            type: string
        delegation_type:
          type: string
          enum:
            - direct
            - delegated
            - ad_network
        exclusive:
          type: boolean
        countries:
          type: array
          items:
            type: string
        effective_from:
          type: string
        effective_until:
          type: string
        signal_ids:
          type: array
          items:
            type: string
        signal_tags:
          type: array
          items:
            type: string
        signing_keys:
          type: array
          items:
            type: object
            additionalProperties: {}
      required:
        - url
      additionalProperties: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        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-server` and the protected-resource
        metadata at `/.well-known/oauth-protected-resource/api`.
    oauth2:
      type: oauth2
      description: >-
        OAuth 2.1 authorization code flow with PKCE. Users authenticate via
        AuthKit and clients receive a Bearer JWT that authorizes both the MCP
        endpoint and this REST API. Dynamic client registration is supported at
        `/register`.
      flows:
        authorizationCode:
          authorizationUrl: https://agenticadvertising.org/authorize
          tokenUrl: https://agenticadvertising.org/token
          refreshUrl: https://agenticadvertising.org/token
          scopes:
            openid: User identifier
            profile: User profile information
            email: User email address

````