> ## 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.

# Create or recover a durable shared preview link to a site route in the API key owner's agent workspace. Start an agent session in the project before sharing. Page availability is checked when the link is opened, not when it is created.



## OpenAPI

````yaml /api-reference/openapi.json post /shared-previews
openapi: 3.1.0
info:
  title: Replo Public API
  version: '2026-10-05'
servers:
  - url: https://api.replo.app/v1
security: []
paths:
  /shared-previews:
    post:
      tags:
        - Shared-previews
      summary: >-
        Create or recover a durable shared preview link to a site route in the
        API key owner's agent workspace. Start an agent session in the project
        before sharing. Page availability is checked when the link is opened,
        not when it is created.
      operationId: sharedPreviews.create
      parameters:
        - name: Replo-Api-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2026-10-05'
          description: The public API version to use for this request.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                projectId:
                  type: string
                  format: uuid
                siteId:
                  type: string
                  format: uuid
                route:
                  type: string
                  minLength: 1
                  maxLength: 2048
                  description: >-
                    The site route to preview, e.g. "/" or "/about". Must be an
                    absolute path without a query string or fragment.
                locale:
                  type: string
                  minLength: 1
                  maxLength: 255
                  description: >-
                    BCP 47 language tag to render the page in, e.g. "en-US".
                    Omit to use the site's default locale.
              required:
                - projectId
                - siteId
                - route
              additionalProperties: false
      responses:
        '200':
          description: >-
            Create or recover a durable shared preview link to a site route in
            the API key owner's agent workspace. Start an agent session in the
            project before sharing. Page availability is checked when the link
            is opened, not when it is created.
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - shared_preview
                  id:
                    type: string
                    format: uuid
                  url:
                    type: string
                    format: uri
                    description: >-
                      Durable link to the requested site route. Page
                      availability is checked when someone opens it; deleting
                      the preview disables the link.
                required:
                  - object
                  - id
                  - url
                additionalProperties: false
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '401':
          description: Missing or invalid Replo Public API token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '403':
          description: You are not authorized to access this resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '404':
          description: Not Found
          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
          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.