Worlds

Prepare World Labs media asset upload

Creates a World Labs media asset record and returns a signed upload URL. Use the returned media_asset_id from native world_prompt objects with source=media_asset. Media assets can only be used by the organization that created them.

post/v1/worlds/media-assets/prepare-upload

Request

  • Base URL: https://api.tokenlab.sh
  • URL: https://api.tokenlab.sh/v1/worlds/media-assets/prepare-upload
  • Auth: HTTP bearer

Request body

file_namestring required

File name, such as landscape.jpg.

kind'image' | 'video' required

High-level media type.

extensionstring nullable

File extension without dot, such as jpg, png, or mp4.

metadataobject nullable

Optional application metadata.

Response

Upload prepared

Changes

No recorded changes to this operation across all 1 revision of this API.