Assets

Create asset collection

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

post/assets/collections

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

{"stackTrail":"paths:/assets/collections:post:requestBody:content:application/json:schema:properties:filters","oasType":"schema","type":"unknown","description":"Assets filter DSL"}

Response

Collection created

Changes

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