Update Asset

PATCH/v1/assets/{assetId}

Update an asset.

Authentication

Authorization Bearer — JWT session or sk-* API key.

Path Parameters

assetIdstringrequired

Asset ID.

groupId can move only ordinary USER_UPLOAD or AI_GENERATED assets to a compatible group. Real Face and Virtual Portrait assets cannot be moved with this endpoint. expiresAt is available only for ordinary assets that support expiration.

Setting status to active requires the asset's group to be active and the asset not to be expired.

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.assetIdstring

Asset public ID.

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

Stable public error code and message, if available.

data.namestring

Display name.

data.filenamestring

Original filename.

data.mimeTypestring

MIME type.

data.sizeBytesstring

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.createdAtstring

Create timestamp.

data.updatedAtstring

Update timestamp.

msgstring

Response message.

serviceCodestring | null

Service error code on failure.

Solicitar

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

Respuesta

JSON

1{
2  "code": 200,
3  "data": {
4    "assetId": "ua_1234567890abcdef",
5    "name": "avatar-renamed.png"
6  },
7  "msg": "success"
8}

Managed asset quota and lifecycle

Virtual Portrait and Real Face uploads share the managed-asset quota for the current personal or tenant scope. Treat Get Asset Quota as the source of truth. The current default is 50,000 for a personal scope and 500,000 for a tenant scope; configured limits may differ.

Use only the public assetId and assetGroupId returned by Token360 in client integrations.

¿Ha sido de ayuda?