---
title: "Delete request payloads"
method: DELETE
path: "/models/requests/{request_id}/payloads"
tags: ["Models", "Requests"]
---

# Delete request payloads

`DELETE /models/requests/{request_id}/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](https://fal.ai/docs/platform-apis/v1/models/requests/payloads) for more details about request payloads.

## Path parameters

- `request_id` string, uuid, required — Unique identifier for the request (UUID format)

## Headers

- `Idempotency-Key` string — Optional idempotency key for safe request retries

## Response `200`

Request payloads deleted successfully

- object — 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
    - `link` string, required — CDN URL of the file that was targeted for deletion
    - `exception` string, nullable, required — Error message if deletion failed for this file, null if successful

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `403` — Access denied
- `404` — Resource not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/fal/apis/platform-apis.md) · [All operations](https://skmtc.dev/fal/apis/platform-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fal/platform-apis/revisions/0c7dabf80b00/schema)