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

# List assets

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



## OpenAPI

````yaml /api-reference/openapi.json get /assets
openapi: 3.1.0
info:
  title: Replo Public API
  version: '2026-06-27'
servers:
  - url: https://public-api.replo.app/api/v1/public
security: []
paths:
  /assets:
    get:
      tags:
        - Assets
      summary: List assets
      description: '**Beta** — this endpoint may change before general availability.'
      operationId: assets.list
      parameters:
        - name: Replo-Api-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2026-06-27'
          description: The public API version to use for this request.
        - schema:
            type: string
            format: uuid
          required: true
          name: projectId
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
            maxItems: 16
          required: false
          name: tags
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
          required: false
          name: searchTerm
          in: query
        - schema:
            type: string
            enum:
              - image
              - video
              - font
              - document
              - audio
            description: AssetType
          required: false
          description: AssetType
          name: type
          in: query
        - schema:
            type: string
            enum:
              - approved
              - draft
              - archived
            description: AssetStatusFilter
          required: false
          description: AssetStatusFilter
          name: status
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 255
          required: false
          name: label
          in: query
        - schema:
            type: integer
            exclusiveMinimum: 0
            maximum: 100
          required: false
          name: limit
          in: query
      responses:
        '200':
          description: List assets
          content:
            application/json:
              schema:
                type: object
                properties:
                  assets:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        url:
                          type: string
                        type:
                          type: string
                          enum:
                            - image
                            - video
                            - font
                            - document
                            - audio
                          description: AssetType
                        projectId:
                          type:
                            - string
                            - 'null'
                        altText:
                          type:
                            - string
                            - 'null'
                        label:
                          type:
                            - string
                            - 'null'
                        tags:
                          type: array
                          items:
                            type: string
                        fileExtension:
                          type: string
                        sizeBytes:
                          type: number
                        width:
                          type:
                            - number
                            - 'null'
                        height:
                          type:
                            - number
                            - 'null'
                        embeddingText:
                          type:
                            - string
                            - 'null'
                        createdAt:
                          type: string
                        updatedAt:
                          type: string
                        approvedAt:
                          type:
                            - string
                            - 'null'
                        archivedAt:
                          type:
                            - string
                            - 'null'
                      required:
                        - id
                        - name
                        - url
                        - type
                        - projectId
                        - altText
                        - label
                        - tags
                        - fileExtension
                        - sizeBytes
                        - width
                        - height
                        - embeddingText
                        - createdAt
                        - updatedAt
                        - approvedAt
                        - archivedAt
                      description: AssetItem
                  summary:
                    type: object
                    properties:
                      status:
                        type: object
                        properties:
                          approved:
                            type: number
                          draft:
                            type: number
                          archived:
                            type: number
                        required:
                          - approved
                          - draft
                          - archived
                      type:
                        type: object
                        properties:
                          image:
                            type: number
                          video:
                            type: number
                          font:
                            type: number
                          document:
                            type: number
                          audio:
                            type: number
                        required:
                          - image
                          - video
                          - font
                          - document
                          - audio
                      labels:
                        type: array
                        items:
                          type: object
                          properties:
                            label:
                              type: string
                            count:
                              type: number
                          required:
                            - label
                            - count
                      tags:
                        type: array
                        items:
                          type: object
                          properties:
                            tag:
                              type: string
                            count:
                              type: number
                          required:
                            - tag
                            - count
                    required:
                      - status
                      - type
                      - labels
                      - tags
                    description: AssetSummary
                required:
                  - assets
                description: AssetFindResponse
        '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'
        '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

````