Assets

Update asset character

Update an asset character for the authenticated user's fal Assets library. Prefer vector IDs or request IDs in reference_images for existing fal-generated assets; use fal-hosted image URLs only for standalone images. Unresolved ID references are materialized before character state is added.

patch/assets/characters/{character_id}

Path parameters

character_idstring required

Character collection ID

Example:d7tatpsregjaga2cf3d0

Character collection ID

Headers

Idempotency-Keystring

Optional idempotency key for safe request retries

Example:550e8400-e29b-41d4-a716-446655440000

Optional idempotency key for safe request retries

Request body

namestring

Character display name

descriptionstring

Text description used for character semantic matching

reference_imagesstring[]

Reference images for the character. Prefer vector IDs or request IDs for existing fal-generated assets. Use fal-hosted image URLs only for standalone images.

cover_image_urlstring uri nullable

Optional fal-hosted cover image URL for the character

Response

Character updated

Changes

No recorded changes to this endpoint across all 2 revisions of this API.