Sign in

v8

latestOpenAPI 3.1.1LicenseRef-Proprietaryraw.githubusercontent.com2026-05-19280916.6 KB
Assets

Get an asset

Returns metadata for one asset when it is accessible to the authenticated public API key. Missing and inaccessible assets both return 404.

get/assets/{assetId}

Path parameters

assetIdstring required

Asset identifier

Example:asset_abc123

Asset identifier

Response

Asset returned.

asset_idstring required

Asset identifier

namestring nullable required

Asset name

descriptionstring nullable required

Asset description

workspace_idstring nullable required

Workspace identifier

urlstring uri nullable required

Asset URL

content_typestring required

Asset content type

upload_content_typestring nullable required

Content type provided at upload time

size_bytesinteger nullable required
uploaded_viastring required

Asset source

created_atstring date-time nullable required

Asset creation time (ISO 8601 datetime)

status'pending_upload' | 'ready' | 'failed' required
failure_messagestring nullable required

Failure message when the asset is in failed status

widthinteger nullable required
heightinteger nullable required

Example response

{
  "asset_id": "asset_abc123",
  "workspace_id": "ws_abc123"
}