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.

{
  "cdn_delete_results": [
    {
      "link": "https://v3.fal.media/files/example/output.png"
    }
  ]
}