Assets API

Update Asset

Update an asset’s name or visibility. With API-key auth the asset must be owned by the key owner; organization-shared assets can only be updated from an admin/owner session.

Authentication

x-api-keystring
API Key authentication via header

Path parameters

idstringRequired
A unique identifier for an asset.

Request

This endpoint expects an object.
namestringOptional
A new display name for the asset.
visibilityenumOptional
Update who can see the asset.

Response

Asset updated successfully
idstring
A unique identifier for an asset.
createdAtdatetime
The date and time the asset was created.
updatedAtdatetime
The date and time the asset was last updated.
typeenum
The type of asset file.
visibilityenum
Visibility scope for the asset.
namestring
The filename of the asset.
urlstring
The URL to access the asset media.
sizelong
File size in bytes.
formatstring

File format/extension (e.g., “mp4”, “wav”).

inputTypeenum
The source type of the asset.
durationSecondsdouble

Duration of the media in seconds (for audio/video).

thumbnailUrlstring
URL to the asset's thumbnail image.
widthinteger

Width in pixels (for video/image).

heightinteger

Height in pixels (for video/image).

projectIdstring
The id of the project this asset is attached to, or null when it belongs to no project.

Errors

401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error