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

# Get a reusable asset

> Read an asset you own or can access in the key’s workspace or public library.

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


## OpenAPI

````yaml GET /assets/{id}
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/{id}:
    get:
      tags:
        - Assets
      summary: Get a reusable asset
      description: >-
        Read an asset you own or can access in the key’s workspace or public
        library.
      operationId: getAsset
      parameters:
        - name: id
          in: path
          required: true
          description: Image or asset ID from a previous response.
          schema:
            type: string
            description: Resource ID.
            format: uuid
      responses:
        '200':
          description: >-
            Read an asset you own or can access in the key’s workspace or public
            library.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Asset'
              example:
                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
        default:
          description: >-
            Request rejected or service error. See the errors and recovery
            guide.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    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.

````