Sign in
OpenAPI 3.1.02026-08-143781,4501.9 MB

3b2cee2701a3

Assets

Upload Asset

Upload a new asset.

post/v1/assets

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.

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"
}