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

# List reusable assets

> Set paginated=true to receive assets and page_info. Without it, the response is a bare array. type defaults to model. Set include_public=true to include shared library assets.

[Work with reusable assets](/api-reference/assets-workflow).


## OpenAPI

````yaml GET /assets
openapi: 3.0.3
info:
  title: bitStudio API
  version: '2026-09-06'
  description: >-
    Core Studio image, video, and reusable-asset workflows. Requests use a
    workspace-scoped API key and the account’s feature access and credits.
    Generation is asynchronous.
  contact:
    name: bitStudio support
    email: hello@bitstudio.ai
servers:
  - url: https://api.bitstudio.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Images
  - name: Video
  - name: Assets
paths:
  /assets:
    get:
      tags:
        - Assets
      summary: List reusable assets
      description: >-
        Set paginated=true to receive assets and page_info. Without it, the
        response is a bare array. type defaults to model. Set
        include_public=true to include shared library assets.
      operationId: listAssets
      parameters:
        - name: type
          in: query
          required: false
          description: Asset type, such as model, outfit, or preset.
          schema:
            type: string
            description: ''
            default: model
        - name: paginated
          in: query
          required: false
          description: Enable cursor pagination.
          schema:
            type: boolean
            description: ''
            default: false
        - name: include_public
          in: query
          required: false
          description: Include shared library assets.
          schema:
            type: boolean
            description: ''
            default: false
        - name: public_only
          in: query
          required: false
          description: Return public assets only.
          schema:
            type: boolean
            description: ''
            default: false
        - name: limit
          in: query
          required: false
          description: Page size in paginated mode.
          schema:
            type: integer
            description: ''
        - name: cursor
          in: query
          required: false
          description: Opaque page_info.next_cursor from the last response.
          schema:
            type: string
            description: ''
        - name: search
          in: query
          required: false
          description: Name search in paginated mode.
          schema:
            type: string
            description: ''
        - name: classes
          in: query
          required: false
          description: Class filters in paginated mode.
          schema:
            type: array
            items:
              type: string
              description: ''
            description: ''
      responses:
        '200':
          description: >-
            Set paginated=true to receive assets and page_info. Without it, the
            response is a bare array. type defaults to model. Set
            include_public=true to include shared library assets.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/AssetsPage'
                  - type: array
                    items:
                      $ref: '#/components/schemas/Asset'
                    description: ''
              example:
                assets:
                  - id: 22222222-2222-4222-8222-222222222222
                    type: outfit
                    alias: Blue striped shirt
                    sku: SHIRT-BLUE-01
                    display_image: >-
                      https://media.bitstudio.ai/public/homepage/2026-09/bitstudio-shirt-reference-front-v1-77caf2ea41d661e4.webp
                    public: false
                page_info:
                  next_cursor: null
                  has_next_page: false
                  limit: 20
                total_count: 1
                facets: {}
        default:
          description: >-
            Request rejected or service error. See the errors and recovery
            guide.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AssetsPage:
      type: object
      properties:
        assets:
          type: array
          items:
            $ref: '#/components/schemas/Asset'
          description: ''
        page_info:
          type: object
          properties:
            next_cursor:
              type: string
              description: Opaque pagination cursor.
              nullable: true
            has_next_page:
              type: boolean
              description: ''
            limit:
              type: integer
              description: ''
          required:
            - next_cursor
            - has_next_page
            - limit
        total_count:
          type: integer
          description: ''
        facets:
          type: object
          properties: {}
      required:
        - assets
        - page_info
        - total_count
    Asset:
      type: object
      properties:
        id:
          type: string
          description: Resource ID.
          format: uuid
        type:
          type: string
          description: model (avatar), outfit, preset, pose, set, style, or shoot.
        alias:
          type: string
          description: Display name.
          nullable: true
        sku:
          type: string
          description: Your product identifier.
          nullable: true
        class:
          type: string
          description: Category within the asset type.
          nullable: true
        characteristics:
          type: string
          description: Description used to guide generation.
          nullable: true
        description:
          type: string
          description: ''
          nullable: true
        display_image:
          type: string
          description: Thumbnail URL. A thumbnail alone is not a generation reference.
          nullable: true
        public:
          type: boolean
          description: Whether the asset belongs to the shared public library.
          nullable: true
        created_timestamp:
          type: string
          description: ''
          format: date-time
      required:
        - id
        - type
    Error:
      type: object
      properties:
        error:
          type: string
          description: Some handlers return a plain error string.
        code:
          type: string
          description: Structured error code, when available.
        message:
          type: string
          description: Structured human-readable error, when available.
        cta:
          type: boolean
          description: Whether the response includes an account action.
        next_action:
          type: string
          description: Suggested action, such as a plan or credit change.
        current_plan:
          type: string
          description: ''
        user_message:
          type: string
          description: User-facing explanation when present.
        extra_context:
          type: string
          description: Additional error context when present.
      description: >-
        Error shapes differ by endpoint. Read message or error; preserve the
        HTTP status and code. Additional context fields may be returned.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Create an API key in Studio → account menu → API Keys. Keep it on your
        server.

````