Update Asset

PATCH/v1/assets/{assetId}

Update an asset.

Authentication

Authorization Bearer

API key as bearer token in Authorization header.

Path Parameters

assetIdstringrequired

Asset ID.

Request Body

namestring

Optional new display name.

groupIdstring

Optional target asset group ID.

statusstring

Set to active or inactive.

expiresAtstring

Optional ISO-8601 expiration time.

Response

codeinteger

Response status code.

dataobject

Updated asset record.

data.idinteger

Internal asset ID.

data.assetIdstring

Asset public ID.

data.token360AssetIdstring

Backward-compatible alias of assetId.

data.tenantIdinteger

Tenant ID.

data.userIdinteger

Owner user ID.

data.userNamestring

Owner display name.

data.sharedboolean

Whether the asset is shared with the caller.

data.sharePermissionstring

Share permission when shared.

data.shareExpiresAtstring

Share expiry time when shared.

data.assetGroupIdstring

Asset group public ID.

data.groupNamestring

Asset group name.

data.mediaTypestring

Image/video/audio.

data.assetKindstring

Asset kind.

data.sourceTypestring

Asset source type.

data.statusstring

Asset status.

data.providerLastErrorobject

Provider-level error details, if any.

data.namestring

Display name.

data.filenamestring

Original filename.

data.mimeTypestring

MIME type.

data.sizeBytesinteger

Asset size in bytes.

data.fileTypestring

File extension/format.

data.widthinteger

Width in pixels.

data.heightinteger

Height in pixels.

data.aspectRatiostring

Calculated aspect ratio.

data.durationSecondsnumber

Media duration in seconds.

data.frameRatenumber

Video frame rate.

data.urlstring

Accessible content URL.

data.thumbnailUrlstring

Thumbnail URL, if available.

data.expiresAtstring

Asset expiry timestamp.

data.requestIdstring

Request ID from asset generation provenance.

data.modelNamestring

Model name used to generate the asset.

data.modelTypestring

Model type used to generate the asset.

data.byteplusAssetIdstring

Provider identifier for BYTEPLUS assets.

data.providerRefsobject

Provider references by kind.

data.createdAtstring

Create timestamp.

data.updatedAtstring

Update timestamp.

msgstring

Response message.

serviceCodestring | null

Service error code on failure.

Request

Shell

1curl -X PATCH https://api.token360.ai/v1/assets/{assetId} \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{"name":"avatar-renamed.png","description":"Updated asset name"}'

Response

JSON

1{
2  "code": 0,
3  "data": {
4    "assetId": "asset_123",
5    "name": "avatar-renamed.png"
6  },
7  "msg": "Asset updated successfully"
8}

Was this page helpful?