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

# Re-check a publisher catalog

> Re-read one storefront-owned publisher's live adagents.json and AAO-selected format catalog, then return the refreshed roster projection and actionable authorization, identity, and format reconciliation states.



## OpenAPI

````yaml /v2/storefront-api-v2.yaml post /property-roster/publishers/{domain}/refresh
openapi: 3.0.0
info:
  title: Scope3 Storefront API
  version: 2.0.0
  description: |-
    REST API for partners to manage storefronts, inventory sources, and billing.

    ## Authentication

    All endpoints require a Bearer token in the Authorization header:
    ```
    Authorization: Bearer your-api-key
    ```

    ## Base URL

    `https://api.interchange.io/api/v2/storefront`

    ## For AI Agents

    AI agents can use the MCP endpoint at `/mcp/v2/storefront` with three tools:
    - `initialize`: Start an MCP session
    - `api_call`: Make REST API calls
    - `ask_about_capability`: Learn about API features
servers:
  - url: https://api.interchange.io/api/v2/storefront
    description: Production server
security: []
tags:
  - name: Account
    description: Account management, service tokens, and preferences
  - name: Asks
    description: >-
      What you are waiting on Scope3 for — support, product, and supply asks in
      one list
  - name: Storefront
    description: Manage storefront and inventory sources
  - name: Storefront Agents
    description: List and manage registered sales, signals, and outcomes agents
  - name: Storefront Activity
    description: Audit log of configuration and inventory changes on the storefront
  - name: Storefront Billing
    description: Payout bank details and billing configuration for storefronts
  - name: AI Usage
    description: Storefront AI token usage visibility by model
  - name: MCP
    description: Model Context Protocol endpoints
paths:
  /property-roster/publishers/{domain}/refresh:
    post:
      tags:
        - Storefront
      summary: Re-check a publisher catalog
      description: >-
        Re-read one storefront-owned publisher's live adagents.json and
        AAO-selected format catalog, then return the refreshed roster projection
        and actionable authorization, identity, and format reconciliation
        states.
      operationId: refreshRosterPublisher
      parameters:
        - in: path
          name: domain
          schema:
            description: >-
              A publisher domain already present on the authenticated seller
              storefront.
            type: string
            minLength: 1
          required: true
          description: >-
            A publisher domain already present on the authenticated seller
            storefront.
      responses:
        '200':
          description: Re-check a publisher catalog
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshRosterPublisherResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    RefreshRosterPublisherResponse:
      description: >-
        The refreshed publisher roster projection and authoritative post-check
        authorization, identity-catalog, and format-catalog states. Formats
        remain sourced from AAO's publisher catalog resolution.
      type: object
      properties:
        publisher:
          type: object
          properties:
            domain:
              type: string
            provenance:
              type: string
              enum:
                - declared
                - crawled
                - discovered
            adagentsStatus:
              nullable: true
              type: string
              enum:
                - resolved
                - no_adagents
                - invalid
                - error
                - pending
            authorizationStatus:
              nullable: true
              type: string
              enum:
                - authorized
                - unauthorized
                - unknown
            authorizationReason:
              nullable: true
              type: string
              enum:
                - no_file
                - file_invalid
                - agent_not_listed
                - agent_untyped
                - agent_not_property_bound
                - authorized
            lastSyncedAt:
              nullable: true
              type: string
            formatCatalogSyncedAt:
              description: >-
                When AAO last returned a definitive format catalog for this
                publisher. This is independent of the live-origin authorization
                check.
              nullable: true
              type: string
            identityCatalogStatus:
              description: >-
                Whether the latest publisher re-check completely reconciled
                publisher-declared properties and collections into this roster.
              nullable: true
              type: string
              enum:
                - pending
                - complete
                - incomplete
                - not_applicable
                - failed
            formatCatalogStatus:
              description: >-
                Whether the latest publisher re-check completely reconciled the
                AAO-selected creative-format catalog into this roster.
              nullable: true
              type: string
              enum:
                - pending
                - complete
                - not_applicable
                - failed
            properties:
              type: array
              items:
                type: object
                properties:
                  propertyKey:
                    type: string
                  propertyId:
                    nullable: true
                    type: string
                  propertyType:
                    nullable: true
                    type: string
                  name:
                    nullable: true
                    type: string
                  identifiers:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                        value:
                          type: string
                      required:
                        - type
                        - value
                      additionalProperties: false
                  tags:
                    type: array
                    items:
                      type: string
                  provenance:
                    description: >-
                      Origin of the identity record: the publisher-hosted
                      adagents.json, a contributed AAO Registry record awaiting
                      publisher-origin proof, or a property the seller declared
                      conversationally before any publisher-origin declaration
                      exists. Publisher-origin resolution supersedes a
                      seller-declared record with the same property key.
                    type: string
                    enum:
                      - publisher_adagents
                      - aao_registry
                      - seller_declared
                  authorization:
                    description: >-
                      Per-property authorization. `status: unauthorized` is
                      definite — the publisher domain does not authorize us, so
                      nothing under it is sellable. `authorized` is inherited
                      from the domain (see `grain`), not proven against the
                      agent selector. `unknown` means no publisher-origin
                      declaration backs this property.
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - authorized
                          - unauthorized
                          - unknown
                      grain:
                        type: string
                        enum:
                          - domain
                      reason:
                        nullable: true
                        type: string
                        enum:
                          - no_file
                          - file_invalid
                          - agent_not_listed
                          - agent_untyped
                          - agent_not_property_bound
                          - authorized
                    required:
                      - status
                      - grain
                      - reason
                    additionalProperties: false
                  declaredBySellerAt:
                    nullable: true
                    type: string
                  firstSeenAt:
                    type: string
                  lastSeenAt:
                    type: string
                required:
                  - propertyKey
                  - propertyId
                  - propertyType
                  - name
                  - identifiers
                  - tags
                  - provenance
                  - authorization
                  - declaredBySellerAt
                  - firstSeenAt
                  - lastSeenAt
                additionalProperties: false
            collections:
              type: array
              items:
                type: object
                properties:
                  collectionId:
                    type: string
                  name:
                    nullable: true
                    type: string
                  tags:
                    type: array
                    items:
                      type: string
                  provenance:
                    description: >-
                      Origin of the identity record: the publisher-hosted
                      adagents.json, a contributed AAO Registry record awaiting
                      publisher-origin proof, or a property the seller declared
                      conversationally before any publisher-origin declaration
                      exists. Publisher-origin resolution supersedes a
                      seller-declared record with the same property key.
                    type: string
                    enum:
                      - publisher_adagents
                      - aao_registry
                      - seller_declared
                  firstSeenAt:
                    type: string
                  lastSeenAt:
                    type: string
                required:
                  - collectionId
                  - name
                  - tags
                  - provenance
                  - firstSeenAt
                  - lastSeenAt
                additionalProperties: false
            formats:
              type: array
              items:
                type: object
                properties:
                  formatKey:
                    type: string
                  formatOptionId:
                    nullable: true
                    type: string
                  displayName:
                    nullable: true
                    type: string
                  formatKind:
                    anyOf:
                      - type: string
                        enum:
                          - image
                      - type: string
                        enum:
                          - html5
                      - type: string
                        enum:
                          - display_tag
                      - type: string
                        enum:
                          - image_carousel
                      - type: string
                        enum:
                          - video_hosted
                      - type: string
                        enum:
                          - video_vast
                      - type: string
                        enum:
                          - audio_hosted
                      - type: string
                        enum:
                          - audio_daast
                      - type: string
                        enum:
                          - sponsored_placement
                      - type: string
                        enum:
                          - native_in_feed
                      - type: string
                        enum:
                          - responsive_creative
                      - type: string
                        enum:
                          - agent_placement
                      - type: string
                        enum:
                          - custom
                  params:
                    type: object
                    additionalProperties: {}
                  appliesToPropertyIds:
                    type: array
                    items:
                      type: string
                  appliesToPropertyTags:
                    type: array
                    items:
                      type: string
                  applicablePropertyKeys:
                    type: array
                    items:
                      type: string
                  applicablePropertyKeysTruncated:
                    type: boolean
                  appliesToAllProperties:
                    type: boolean
                  sellerPreference:
                    nullable: true
                    type: string
                  experimental:
                    nullable: true
                    type: boolean
                  provenance:
                    type: string
                    enum:
                      - publisher_adagents
                      - aao_registry
                  firstSeenAt:
                    type: string
                  lastSeenAt:
                    type: string
                required:
                  - formatKey
                  - formatOptionId
                  - displayName
                  - formatKind
                  - params
                  - appliesToPropertyIds
                  - appliesToPropertyTags
                  - applicablePropertyKeys
                  - applicablePropertyKeysTruncated
                  - appliesToAllProperties
                  - sellerPreference
                  - experimental
                  - provenance
                  - firstSeenAt
                  - lastSeenAt
                additionalProperties: false
            propertyCount:
              description: >-
                Total live properties on this domain. Greater than
                properties.length when the response was bounded.
              type: integer
              minimum: 0
              maximum: 9007199254740991
            collectionCount:
              description: >-
                Total live AdCP Collections on this domain. Greater than
                collections.length when the response was bounded.
              type: integer
              minimum: 0
              maximum: 9007199254740991
            formatCount:
              description: >-
                Total live creative formats on this domain. Greater than
                formats.length when the response was bounded.
              type: integer
              minimum: 0
              maximum: 9007199254740991
          required:
            - domain
            - provenance
            - adagentsStatus
            - authorizationStatus
            - authorizationReason
            - lastSyncedAt
            - formatCatalogSyncedAt
            - identityCatalogStatus
            - formatCatalogStatus
            - properties
            - collections
            - formats
            - propertyCount
            - collectionCount
            - formatCount
          additionalProperties: false
        sync:
          type: object
          properties:
            pushedToManagedAgent:
              type: boolean
            adagentsStatus:
              nullable: true
              type: string
              enum:
                - resolved
                - no_adagents
                - invalid
                - error
                - pending
            authorizationStatus:
              nullable: true
              type: string
              enum:
                - authorized
                - unauthorized
                - unknown
            authorizationReason:
              nullable: true
              type: string
              enum:
                - no_file
                - file_invalid
                - agent_not_listed
                - agent_untyped
                - agent_not_property_bound
                - authorized
            identityStatus:
              nullable: true
              type: string
              enum:
                - pending
                - complete
                - incomplete
                - not_applicable
                - failed
            formatStatus:
              nullable: true
              type: string
              enum:
                - pending
                - complete
                - not_applicable
                - failed
          required:
            - pushedToManagedAgent
            - adagentsStatus
            - authorizationStatus
            - authorizationReason
            - identityStatus
            - formatStatus
          additionalProperties: false
      required:
        - publisher
        - sync
      additionalProperties: false
    ErrorResponse:
      description: Standard error response
      type: object
      properties:
        data:
          type: string
          nullable: true
          enum:
            - null
        error:
          $ref: '#/components/schemas/ApiError'
      required:
        - data
        - error
      additionalProperties: false
    ApiError:
      description: Structured error object
      type: object
      properties:
        code:
          description: Machine-readable error code
          type: string
        message:
          description: Human-readable error message
          type: string
        field:
          description: Field path associated with the error
          type: string
        details:
          description: Additional error context
          type: object
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or access token

````