---
title: "Update Seedance material asset"
method: PUT
path: "/v1/videos/assets/{assetId}"
tags: ["Video"]
---

# Update Seedance material asset

`PUT /v1/videos/assets/{assetId}`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/videos/assets/{assetId}`
- Auth: `bearerAuth` (a scheme the document does not define)

Updates a Seedance material asset owned by the authenticated organization.

## Path parameters

- `assetId` string, required

## Request body

- SeedanceMaterialAssetUpdateRequest
  - `asset_url` string, uri: Replacement publicly reachable material asset URL.
  - `asset_name` string: Updated display name stored with the material asset.
  - `asset_type` 'Image' | 'Video' | 'Audio'
  - `project_name` string
  - `metadata` object, nullable: Updated client metadata stored with the material asset.

## Response `200`

Material asset updated

- SeedanceMaterialAsset
  - `id` string, required: TokenLab material asset ID. Use this as material_asset_id after the asset becomes ACTIVE.
  - `object` 'seedance.material_asset', required
  - `group_id` string, nullable: TokenLab material group ID that owns this material asset.
  - `project_name` string: Project scope for this material asset.
  - `library_type` 'aigc_avatar' | 'liveness_face', required
  - `asset_name` string, nullable
  - `asset_type` 'Image' | 'Video' | 'Audio', required
  - `status` 'PROCESSING' | 'ACTIVE' | 'FAILED' | 'DELETED', required
  - `ready` boolean, required: True when the asset is active and not deleted.
  - `error_message` string, nullable: Public-safe terminal processing error. Permanent source validation failures include the rejected dimension constraint.
  - `metadata` object, nullable
  - `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.

## Other responses

- `400`: Bad Request - Invalid input
- `401`: Unauthorized - Invalid or missing API key
- `404`: Not Found
- `409`: Material asset is still processing or has failed without an active replica
- `422`: The stored material source failed permanent validation
- `500` (unresolved $ref)
- `503`: Material library unavailable

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)