Skip to main content
DELETE
/
v1
/
requests
/
{request_id}
/
payloads
curl -X DELETE "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw/payloads" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "id": "req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
  "purged": true,
  "already_purged": false,
  "media_deleted": 2
}
Permanently deletes the stored request body, response body, and any associated media files for a specific request. The request metadata (cost, timing, model, status) is preserved - only the payload data is removed. This operation is idempotent. Calling it on an already-purged request returns a success response with already_purged set to true.
This endpoint uses the native Lumenfall API path (/v1/requests), not the OpenAI-compatible prefix (/openai/v1).

​
Path parameters

​
request_id
string
required
The ID of the request whose payloads should be purged (e.g., req_2m4jLFHhkN1i4VrVHpjJqCOKlPw).

​
Response

​
id
string
The request ID that was purged.
​
purged
boolean
Always true on a successful response.
​
already_purged
boolean
true if the request was already purged in a previous call. false if this call performed the purge.
​
media_deleted
integer
The number of media files deleted from storage. 0 if the request had no stored media or was already purged.
curl -X DELETE "https://api.lumenfall.ai/v1/requests/req_2m4jLFHhkN1i4VrVHpjJqCOKlPw/payloads" \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "id": "req_2m4jLFHhkN1i4VrVHpjJqCOKlPw",
  "purged": true,
  "already_purged": false,
  "media_deleted": 2
}