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.