---
title: "Get Media Asset"
method: GET
path: "/marble/v1/media-assets/{media_asset_id}"
---

# Get Media Asset

`GET /marble/v1/media-assets/{media_asset_id}`

## Request

- Base URL: `https://api.worldlabs.ai`
- URL: `https://api.worldlabs.ai/marble/v1/media-assets/{media_asset_id}`
- Auth: API key in header `WLT-Api-Key`
- TypeScript: <https://skmtc.dev/worldlabs/apis/marble-public-api-v1/docs/marble/v1/media-assets/:media_asset_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a media asset by ID.

Retrieves metadata for a previously created media asset.

Args:
    media_asset_id: The media asset identifier.

Returns:
    MediaAsset object with media_asset_id, file_name, extension, kind,
    metadata, created_at, and updated_at.

Raises:
    HTTPException: 404 if not found

## Path parameters

- `media_asset_id` string, required

## Response `200`

Successful Response

- MediaAsset: A user-uploaded media asset stored in managed storage. MediaAssets can be images, videos, or binary blobs that are used as input to world generation.
  - `created_at` string, date-time, required: Creation timestamp
  - `extension` string, nullable: File extension without dot
  - `file_name` string, required: File name
  - `kind` 'image' | 'video', required: High-level media asset type.
  - `media_asset_id` string, required: Server-generated media asset identifier
  - `metadata` object, nullable: Optional application-specific metadata
  - `updated_at` string, date-time, nullable: Last update timestamp

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/worldlabs/apis/marble-public-api-v1.md) - [All operations](https://skmtc.dev/worldlabs/apis/marble-public-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/worldlabs/apis/marble-public-api-v1/revisions/4a3ed614672e?raw)