latestOpenAPI 3.1.02026-08-203871,4682.0 MB

db6eec599cbe

Assets

Get Asset

Retrieve a single asset by ID.

get/v1/assets/{asset_id}

Path parameters

asset_idstring required

ID of the asset.

Example:5xM2KqOnZyce22SPZ9d4

ID of the asset.

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

asset_idstring required

Unique identifier for the asset.

namestring required

Display name of the asset.

mime_typestring required

MIME type of the uploaded file (e.g. audio/mpeg).

created_at_unixinteger required

Unix timestamp (seconds) the asset was created.

content_urlstring nullable required

Signed URL to fetch the asset's content. May be null if the asset has not finished processing. Do not rely on it being valid for more than 1 hour; fetch the asset again for a fresh URL.

Example response

{
  "asset_id": "5xM2KqOnZyce22SPZ9d4",
  "content_url": "https://.../a1b2c3d4/content?...",
  "created_at_unix": 1721520000,
  "mime_type": "audio/mpeg",
  "name": "podcast-intro.mp3"
}