Skip to main content
PUT
Update a reusable asset
Work with reusable assets.

Authorizations

Authorization
string
header
required

Create an API key in Studio → account menu → API Keys. Keep it on your server.

Path Parameters

id
string<uuid>
required

Image or asset ID from a previous response. Resource ID.

Body

application/json
type
enum<string>

Use model for an avatar, outfit for a product, or preset for a reusable visual setup.

Available options:
model,
outfit,
preset,
pose,
set,
style,
shoot
alias
string

Human-readable name.

Maximum string length: 50
sku
string

Product identifier for wardrobe items.

class
string

For presets: human_studio, human_location, ghost_mannequin, flat_lay, or product_packshot.

characteristics
string

Description or reusable prompt.

description
string

Optional descriptive text.

display_image
string

Thumbnail URL only. Also upload or link reference images before generating.

tag_ids
string<uuid>[]

Existing tag IDs.

Resource ID.

Response

Update an accessible asset’s metadata. Include the existing type. Upload reference photos separately.

id
string<uuid>
required

Resource ID.

type
string
required

model (avatar), outfit, preset, pose, set, style, or shoot.

alias
string | null

Display name.

sku
string | null

Your product identifier.

class
string | null

Category within the asset type.

characteristics
string | null

Description used to guide generation.

description
string | null
display_image
string | null

Thumbnail URL. A thumbnail alone is not a generation reference.

public
boolean | null

Whether the asset belongs to the shared public library.

created_timestamp
string<date-time>