> ## Documentation Index > Fetch the complete documentation index at: https://docs.runflow.io/llms.txt > Use this file to discover all available pages before exploring further. # Get asset > Retrieve a single asset by ID. ## OpenAPI ````yaml /api/openapi.public.json get /v1/assets/{id} openapi: 3.1.0 info: title: Runflow API version: 0.1.0 description: >- Public Runflow API. Run AI image and video models, manage media, inspect run history, and configure webhooks. Auth: HTTP Bearer. This document is the customer integration surface only. Admin and internal operations plus generic system reference-data tables are intentionally omitted. servers: - url: https://api.runflow.io description: Production security: - HTTPBearer: [] tags: - name: Models description: >- Browse the model catalog and dispatch model runs. The primary surface for running AI image and video generation. - name: Runs description: >- Inspect, cancel, and re-run model executions. Fetch logs, node-runs, and callback delivery history. - name: Media description: >- Upload images and videos as inputs. Organize assets into folders. Three-step presigned upload flow for large files. - name: Batches description: >- Run a model on multiple inputs in one request. Includes per-item status and a single callback when the batch completes. - name: Evaluations description: >- Submit an image generated anywhere for automated quality evaluation, then read a pass verdict, a 0-1 score, and structured issues. No Runflow run required. - name: Webhooks description: >- Subscribe to platform events. Inspect delivery history, redeliver failed callbacks, manage signing secrets. - name: Account description: Read your account identity and credit balance. - name: Status description: Health and readiness probes for the API. paths: /v1/assets/{id}: get: tags: - Media summary: Get asset description: Retrieve a single asset by ID. operationId: getAsset parameters: - name: id in: path required: true schema: type: string format: uuid title: Id - name: add_signature in: query required: false schema: type: boolean description: >- Replace url and thumbnail_url with presigned GET URLs valid for up to 1 week. Default: true on detail (GET /assets/{id}), false on search (GET /assets). When false, storage does not need to be configured. default: true title: Add Signature description: >- Replace url and thumbnail_url with presigned GET URLs valid for up to 1 week. Default: true on detail (GET /assets/{id}), false on search (GET /assets). When false, storage does not need to be configured. - name: embed in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Relation embedding. Available values: created_by_user. Use a comma-separated list to request multiple embeds. title: Embed description: >- Relation embedding. Available values: created_by_user. Use a comma-separated list to request multiple embeds. examples: single: summary: Single embed value: created_by_user - name: X-Organization-Id in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Organization-Id responses: '200': description: The requested asset. content: application/json: schema: $ref: '#/components/schemas/models__asset__Asset__FullValidator' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - HTTPBearer: [] components: schemas: models__asset__Asset__FullValidator: properties: id: anyOf: - type: string format: uuid - type: 'null' title: Id org_id: anyOf: - type: string format: uuid - type: 'null' title: Org Id folder_id: anyOf: - type: string format: uuid - type: 'null' title: Folder Id name: anyOf: - type: string - type: 'null' title: Name r2_key: anyOf: - type: string - type: 'null' title: R2 Key url: anyOf: - type: string - type: 'null' title: Url thumbnail_url: anyOf: - type: string - type: 'null' title: Thumbnail Url mime_type: anyOf: - type: string - type: 'null' title: Mime Type size_bytes: anyOf: - type: integer - type: 'null' title: Size Bytes asset_type: anyOf: - type: string - type: 'null' title: Asset Type source_type: anyOf: - type: string - type: 'null' title: Source Type source_id: anyOf: - type: string - type: 'null' title: Source Id created_by: anyOf: - type: string format: uuid - type: 'null' title: Created By created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At deleted_at: anyOf: - type: string format: date-time - type: 'null' title: Deleted At deleted_by: anyOf: - type: string format: uuid - type: 'null' title: Deleted By created_by_user: anyOf: - $ref: '#/components/schemas/EmbedValidator' - type: 'null' type: object title: FullValidator description: Response shape. ErrorResponse: properties: code: type: string title: Code message: type: string title: Message errors: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Errors type: object required: - code - message title: ErrorResponse description: Standard error envelope — matches exception handler output. EmbedValidator: properties: id: anyOf: - type: string format: uuid - type: 'null' title: Id email: anyOf: - type: string - type: 'null' title: Email first_name: anyOf: - type: string - type: 'null' title: First Name last_name: anyOf: - type: string - type: 'null' title: Last Name avatar_url: anyOf: - type: string - type: 'null' title: Avatar Url type: object required: - id - email - first_name - last_name - avatar_url title: EmbedValidator description: |- Minimal user shape for embedded user fields. Includes only display-relevant fields. Excludes sensitive/admin fields: email_verified_at, disabled_at, is_internal, locale_code, timezone. securitySchemes: HTTPBearer: type: http scheme: bearer ````