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

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.

Required permissions: models:requests:write, assets:write. Key presets that include them: FULL. See key permissions.

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>'

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

Key on the FULL preset, or any key whose permissions include the ones this API lists. Prefix it with "Key ", e.g. Authorization: Key YOUR_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

Hide child attributes

cdn_delete_results.link

string

required

CDN URL of the file that was targeted for deletion

Example:

"https://v3.fal.media/files/example/output.png"

cdn_delete_results.exception

string | null

required

Error message if deletion failed for this file, null if successful

Example:

null

⌘I

Delete request payloads

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

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