Skip to content
fal.ai Docs
Dashboard

Payloads

When a request is made to a fal.ai Model API, the payloads (input and output) are stored in the platform for 30 days by default.

Deleting IO Payloads

You can delete a request’s payloads and the CDN files found in the output of the request using the delete IO endpoint. This is useful for removing generated images, files, or other media from the platform.

Authentication

The delete IO endpoint requires an API key with ADMIN scope. Check the Authentication section for more information.

Endpoint

PUT https://rest.alpha.fal.ai/requests/delete_io/{request_id}

Parameters

  • request_id (string, required): The ID of the request whose IO files you want to delete

Headers

  • Authorization: Key {fal_key} - Your fal.ai API key with admin scope

Example call

Terminal window
curl --location --request PUT 'https://rest.alpha.fal.ai/requests/delete_io/{request_id}' \
--header 'Authorization: Key {KEY}'

Response

The endpoint returns a JSON object containing the results of the deletion operation:

{
  "CDN_DELETE_RESULTS": [
    {
      "link": "https://v3.fal.media/files/rabbit/VAi0muC9Zo3MbDXw5gzV6.png",
      "exception": null
    }
  ]
}

Response Fields

  • CDN_DELETE_RESULTS (array): List of deletion results for each CDN link
    • link (string): The CDN URL that was processed
    • exception (string|null): Error message if deletion failed, null if successful