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

# Get a site publish

> **Beta** — this endpoint may change before general availability.



## OpenAPI

````yaml /api-reference/openapi.json get /sites/{siteId}/publishes/{publishId}
openapi: 3.1.0
info:
  title: Replo Public API
  version: '2026-11-10'
servers:
  - url: https://api.replo.app/v1
security: []
paths:
  /sites/{siteId}/publishes/{publishId}:
    get:
      tags:
        - Sites
      summary: Get a site publish
      description: '**Beta** — this endpoint may change before general availability.'
      operationId: sites.publishes.get
      parameters:
        - name: Replo-Api-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2026-11-10'
          description: The public API version to use for this request.
        - schema:
            type: string
            format: uuid
            description: The ID of the site that was published.
          required: true
          description: The ID of the site that was published.
          name: siteId
          in: path
        - schema:
            type: string
            format: uuid
            description: The publish ID that POST /sites/{siteId}/publishes returned.
          required: true
          description: The publish ID that POST /sites/{siteId}/publishes returned.
          name: publishId
          in: path
      responses:
        '200':
          description: Get a site publish
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - site_publish
                  id:
                    type: string
                    format: uuid
                  siteId:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - queued
                      - running
                      - succeeded
                      - failed
                  sha:
                    type:
                      - string
                      - 'null'
                    description: The commit this publish was asked to build.
                  fault:
                    type:
                      - string
                      - 'null'
                    enum:
                      - site
                      - platform
                      - provider
                      - request
                      - null
                    description: >-
                      Whose problem a failure is. site means the site's code
                      must change before publishing again; the others clear on
                      their own or are ours to fix.
                  code:
                    type:
                      - string
                      - 'null'
                    description: >-
                      A stable name for why the publish failed, such as
                      build.type_error.
                  message:
                    type:
                      - string
                      - 'null'
                    description: What failed, in words an agent can act on.
                  logTail:
                    type:
                      - string
                      - 'null'
                    description: The end of the failed stage's log.
                  createdAt:
                    type: string
                    format: date-time
                  startedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                  finishedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                required:
                  - object
                  - id
                  - siteId
                  - status
                  - sha
                  - fault
                  - code
                  - message
                  - logTail
                  - createdAt
                  - startedAt
                  - finishedAt
                description: PublicSitePublish
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '401':
          description: >-
            Missing or invalid Replo Public API token. Send an active key as
            `Authorization: Bearer replo_sk_...`; if it was revoked, create a
            new key in Replo Settings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '403':
          description: >-
            You are not authorized to access this resource. Ask a workspace
            owner to perform this action or to grant the key's creator access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '404':
          description: >-
            Not Found. The resource may not exist, this key may lack the
            required scope, or the key's creator may have lost access. Check the
            key's scopes in Replo Settings and the creator's project or
            workspace access; a workspace owner can grant access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '409':
          description: The resource is in a conflicting state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '413':
          description: File content exceeds the 10 MiB limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '429':
          description: >-
            Too many requests. Please retry after the time indicated by the
            Retry-After header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '500':
          description: An internal error occurred.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '503':
          description: Service temporarily unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
      security:
        - bearerAuth: []
components:
  schemas:
    PublicApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            doc_url:
              type: string
            issues:
              type: array
              items:
                type: object
                properties:
                  param:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Dotted path to the failing field within the request body,
                      query or path, e.g. "name" or "variants.0.available"; null
                      when the rule covers the whole input.
                  message:
                    type: string
                    description: Why the field was rejected.
                required:
                  - param
                  - message
              description: >-
                Present on an invalid_request whose input failed validation:
                each failing field and why, at most 10.
          required:
            - code
            - message
            - doc_url
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.