---
title: "Delete request data"
method: DELETE
path: "/requests/{request_id}"
tags: ["Requests"]
---

# Delete request data

`DELETE /requests/{request_id}`

## Request

- Base URL: `https://api.higgsfield.ai`
- URL: `https://api.higgsfield.ai/requests/{request_id}`
- Auth: API key in header `Authorization`

Delete a finished request's input and output files, prompt and parameters now, regardless of its retention. Billing records are kept. Repeating the call returns the same response.

## Path parameters

- `request_id` string, uuid, required

## Response `200`

The request data was deleted.

- DeletedRequest
  - `request_id` string, uuid, required
  - `status` 'deleted', required

## Other responses

- `401`: Missing or invalid API credentials.
- `404`: The request does not exist or belongs to another account.
- `409`: The request is still queued or in progress.
- `503`: Deletion is temporarily unavailable. Retry later.

## Changes

- **2026-10-24** `3b78b16075b4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/higgsfield/apis/higgsfield-api/changes/requests/:request_id/delete.md)

---

[API](https://skmtc.dev/higgsfield/apis/higgsfield-api.md) - [All operations](https://skmtc.dev/higgsfield/apis/higgsfield-api/llms.txt) - [OpenAPI document](https://skmtc.dev/higgsfield/apis/higgsfield-api/revisions/3b78b16075b4?raw)
