Upload asset
Upload asset for the authenticated user’s fal Assets library.
POST
Upload asset
Documentation Index
Fetch the complete documentation index at: https://fal.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_API_KEY
Headers
Optional idempotency key for safe request retries
Example:
"550e8400-e29b-41d4-a716-446655440000"
Body
application/json
fal-hosted media URL to ingest into the asset library
Media type for the uploaded asset
Available options:
image, video, audio, 3d Optional caller-provided caption or description to index with the uploaded asset
Required string length:
1 - 2000Optional manual collection ID to add the uploaded asset to
Whether to favorite the uploaded asset immediately
Tag IDs to assign to the uploaded asset
Response
Upload ingested
Asset details
Previous
Get AssetGet an asset document by vector ID from the authenticated user's fal Assets library. The vector may exist only in Turbopuffer; in that case the response returns the Turbopuffer document with empty local state.
Next
Upload asset