FAfal
Assets

Create asset collection

Create asset collection for the authenticated user's fal Assets library.

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

post/assets/collections

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/assets/collections
  • Auth
    API key in header Authorization

Headers

Idempotency-Keystring

Optional idempotency key for safe request retries

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

Request body

namestring required

Collection display name

descriptionstring nullable

Optional collection description

iconstring nullable

Optional collection icon

colorstring nullable

Optional collection color

cover_image_urlstring uri nullable

Optional fal-hosted cover image URL for the collection

parent_collection_idstring nullable

Optional parent collection ID to nest this collection under (manual collections only). Omit or null to create a top-level collection.

filtersunknown

Response

Collection created

Changes

No recorded changes to this operation across all 12 revisions of this API.