Skip to main content
DELETE
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.