Models
Requests
Delete request payloads
Deletes the IO payloads and associated CDN output files for a specific request.
Important:
- Only output CDN files are deleted (input files may be used by other requests)
- This action is irreversible
- Requires authentication with an admin API key
What gets deleted:
- Request input/output payload data
- CDN-hosted output files (images, videos, etc.)
What is NOT deleted:
- Input CDN files (may be referenced by other requests)
Response:
- Returns deletion status for each CDN file
- Each result includes the file link and any error that occurred
Idempotency:
- Optional Idempotency-Key header prevents duplicate deletions on retries
- Responses cached for 10 minutes per unique key
See fal.ai docs for more details about request payloads.
delete/models/requests/{request_id}/payloads
Path parameters
request_idstring uuid required
Unique identifier for the request (UUID format)
Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890
Unique identifier for the request (UUID format)
Headers
Idempotency-Keystring
Optional idempotency key for safe request retries
Example:550e8400-e29b-41d4-a716-446655440000
Optional idempotency key for safe request retries
Response
Request payloads deleted successfully
Example response
{
"cdn_delete_results": [
{
"link": "https://v3.fal.media/files/example/output.png"
}
]
}Changes
No recorded changes to this endpoint across all 2 revisions of this API.