Skip to main content
PUT
Update Seedance material asset
Update the material name or metadata. The source URL and asset type are fixed after creation; create a new asset when the source file changes. project_name isolates resources within the authenticated organization. It 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

Example Response

Path Parameters

assetId
string
required

TokenLab material asset ID.

Body

application/json
asset_url
string<uri>

Replacement publicly reachable material asset URL.

asset_name
string

Updated display name stored with the material asset.

Required string length: 1 - 128
asset_type
enum<string>
Available options:
Image,
Video,
Audio
project_name
string
default:default
Required string length: 1 - 128
metadata
object | null

Updated client metadata stored with the material asset.

Response

Material asset updated

id
string
required

TokenLab material asset ID. Use this as material_asset_id after the asset becomes ACTIVE.

object
enum<string>
required
Available options:
seedance.material_asset
library_type
enum<string>
required
Available options:
aigc_avatar,
liveness_face
asset_type
enum<string>
required
Available options:
Image,
Video,
Audio
status
enum<string>
required
Available options:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
required

True when the asset is active and not deleted.

group_id
string | null

TokenLab material group ID that owns this material asset.

project_name
string

Project scope for this material asset.

asset_name
string | null
error_message
string | null

Public-safe terminal processing error. Permanent source validation failures include the rejected dimension constraint.

metadata
object | null
created_at
integer

Unix timestamp when the material asset record was created.

updated_at
integer

Unix timestamp when the material asset record was last updated.