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

Delete request payloads

curl --request DELETE \
  --url https://api.fal.ai/v1/models/requests/{request_id}/payloads \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fal.ai/v1/models/requests/{request_id}/payloads"

headers = {"Authorization": "<api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/models/requests/{request_id}/payloads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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
    }
  ]
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Access denied"
  }
}

{
  "error": {
    "type": "not_found",
    "message": "Resource not found"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "An unexpected error occurred"
  }
}

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

Show child attributes

Platform APIs for AssetsProgrammatic access to fal Assets for browsing, searching, uploading, and organizing generated media

⌘I

Delete request payloads

curl --request DELETE \
  --url https://api.fal.ai/v1/models/requests/{request_id}/payloads \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fal.ai/v1/models/requests/{request_id}/payloads"

headers = {"Authorization": "<api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/models/requests/{request_id}/payloads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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
    }
  ]
}

{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Access denied"
  }
}

{
  "error": {
    "type": "not_found",
    "message": "Resource not found"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "An unexpected error occurred"
  }
}