FAfal
Assets

Move asset collection

Move a manual asset collection under another collection, or to the top level. Only manual collections can be moved or act as folders; nesting is limited to 5 levels deep and cannot create a cycle.

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

post/assets/collections/{collection_id}/move

Request

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

Path parameters

collection_idstring required

Collection ID

Example:d8b6elcregj72v34jr8g

Headers

Idempotency-Keystring

Optional idempotency key for safe request retries

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

Request body

parent_collection_idstring nullable required

Parent collection ID to move this collection under, or null to move it to the top level. Must be a manual collection; nesting is limited to 5 levels and cannot create a cycle.

Response

Collection moved

Changes

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