Update Asset Group

PATCH/v1/asset-groups/{groupId}

Update an asset group.

Authentication

Authorization Bearer

API key as bearer token in Authorization header.

Path Parameters

groupIdstringrequired

Asset group ID.

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 group record (`UnifiedAssetGroupVO`).

data.idinteger

Internal group ID.

data.assetGroupIdstring

Group public ID.

data.tenantIdinteger

Tenant ID.

data.userIdinteger

Owner user ID.

data.userNamestring

Owner display name.

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

Request

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)","description":"Updated group name"}'

Response

JSON
1{
2  "code": 0,
3  "data": {
4    "groupId": "group_123",
5    "name": "Marketing Assets (renamed)",
6    "description": "Updated group name"
7  },
8  "msg": "Asset group updated"
9}
Was this page helpful?