Update Asset Group

PATCH/v1/asset-groups/{groupId}

Update an asset group.

Authentication

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

Path Parameters

groupIdstringrequired

Asset group ID.

status accepts active or inactive. Setting a group to inactive also makes the assets in that group inactive.

Only the group owner can change membership. addAssetIds and removeAssetIds support movable ordinary assets (USER_UPLOAD and AI_GENERATED); Real Face and Virtual Portrait assets cannot be moved through this endpoint.

Request Body

namestring

Optional display name.

statusstring

Optional status, such as active or inactive.

addAssetIdsarray<string>

Optional asset IDs to add to the group.

removeAssetIdsarray<string>

Optional asset IDs to remove from the group.

Response

codeinteger

Response status code.

dataobject

Updated asset group.

data.assetGroupIdstring

Group public ID.

data.sharedboolean

Whether the group is shared with the caller.

data.sharePermissionstring

Share permission when shared.

data.shareExpiresAtstring

Share expiry time when shared.

data.namestring

Group name.

data.groupKindstring

Group kind.

data.statusstring

Group status.

data.verificationStatusstring

Real Face verification status, when applicable.

data.activationAllowedboolean

Whether the group currently satisfies activation requirements.

data.activationBlockedReasonstring

Reason activation is blocked, when applicable.

data.assetCountinteger

Number of assets in the group.

data.h5Linkstring

Verification link for REAL_FACE groups when pending.

data.defaultUploadTtlDaysinteger

Default upload TTL in days for USER_UPLOAD assets, if configured.

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/asset-groups/{groupId} \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{"name":"Marketing Assets (renamed)"}'

Respuesta

JSON

1{
2  "code": 200,
3  "data": {
4    "assetGroupId": "your-asset-group-id",
5    "name": "Marketing Assets (renamed)"
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?