FAfal
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.

Required permissions: assets:write. Key presets that include them: API, SERVERLESS, FULL. See key permissions.

patch/assets/characters/{character_id}

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/assets/characters/{character_id}
  • Auth
    API key in header Authorization

Path parameters

character_idstring required

Character collection ID

Example:d7tatpsregjaga2cf3d0

Headers

Idempotency-Keystring

Optional idempotency key for safe request retries

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

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 operation across all 12 revisions of this API.