TokenLab

Video & Materials

Update Material Asset Group

Updates a Seedance material group owned by the current organization.

PUT
/v1/videos/assets/groups/{groupId}

Update the display name (group_name), description, or metadata of a material group. Send at least one of them, or the request returns 400. A real-person group keeps its verified person mapping. If a material in the group is still being prepared, the request can return 409; retry shortly.

project_name scopes resources inside your organization and defaults to default. Use the same case-sensitive value for related groups and assets. Send it in the JSON body for POST/PUT and in the query string for GET/DELETE.

Example Request

curl https://api.tokenlab.sh/v1/videos/assets/groups/group-20260720123456-vrt01 \
  -X PUT \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group_name":"Updated references","description":"Images approved for summer videos","project_name":"default"}'

Example Response

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Updated references",
  "description": "Images approved for summer videos",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X PUT "https://example.com/v1/videos/assets/groups/group-20260720123456-vrt01" \  -H "Content-Type: application/json" \  -d '{    "group_name": "Updated references",    "description": "Images approved for summer videos"  }'
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Updated references",  "description": "Images approved for summer videos",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

Authorization

BearerAuth
AuthorizationBearer <token>

API Key authentication. Create or manage API keys in Dashboard > API > API Keys.

In: header

Path Parameters

groupId*string

Request Body

application/json

Response

application/json

application/json

application/json

application/json

application/json

application/json

application/json