Skip to main content
DELETE
/
models
/
requests
/
{request_id}
/
payloads
Delete request payloads
curl --request DELETE \
  --url https://api.fal.ai/v1/models/requests/{request_id}/payloads \
  --header 'Authorization: <api-key>'
{
  "cdn_delete_results": [
    {
      "link": "https://v3.fal.media/files/abc123/output.png",
      "exception": null
    },
    {
      "link": "https://v3.fal.media/files/def456/output.mp4",
      "exception": null
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Admin API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_ADMIN_API_KEY

Headers

​
Idempotency-Key
string

Optional idempotency key for safe request retries

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

​
request_id
string<uuid>
required

Unique identifier for the request (UUID format)

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Response

Request payloads deleted successfully

Response containing the results of deleting request payloads and CDN output files

​
cdn_delete_results
object[]
required

Array of deletion results for each CDN file associated with the request output