Update Asset Description

PUT

/v1/assets/{asset_id}

Update the asset description (purpose). Does not change the asset itself or its status.
This asset endpoint supports the following models:
doubao-seedance-2-0-260128
doubao-seedance-2-0-fast-260128
doubao-seedance-2-0-mini-260615
doubao-seedance-2-5-260628
dreamina-seedance-2-0-hc
dreamina-seedance-2-0-fast-hc
dreamina-seedance-2-0-mini-hc
dreamina-seedance-2-5-hc

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Example

{
    "purpose": "string",
    "group_id": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://www.aiide.com/v1/assets/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "purpose": "string",
    "group_id": "string"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "data": {
        "asset_id": "mat_ADyx4iQvkHUy7jDzPKqp",
        "created_at": 1784686780,
        "group_id": "ak-******",
        "original_url": "https://cdn.example.com/portrait.jpg",
        "purpose": "Updated character reference description",
        "status": "ready",
        "type": "image"
    },
    "message": "",
    "success": true
}

Modified at 2026-09-10 05:59:24

Get Asset

Delete Asset