> ## Documentation Index
> Fetch the complete documentation index at: https://docs.budecosystem.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Response

> Delete a response by ID.

```bash cURL theme={null}
curl -X DELETE https://gateway.bud.studio/v1/responses/resp_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-model-name: gpt-4"
```

```json 200 theme={null}
{
  "id": "resp_abc123",
  "object": "response",
  "deleted": true
}
```

## Headers

| Parameter | Type | Required | Description |
| - | - | - | - |
| Authorization | string | Yes | Bearer authentication header |
| x-model-name | string | No | Model name for routing. Default: gpt-4-responses |

## Path Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| response\_id | string | Yes | The ID of the response to delete |

## Deleting one turn keeps the rest of the thread

A stored turn can be the middle of a conversation, with turns chained after it. Deleting it
re-links its children onto its own parent, so the thread closes over the gap and the turns
older than the deleted one stay reachable from the newer ones.

Without that, forgetting a single turn would silently take every turn before it out of the
next continuation's history — the client asked to delete one response, not the conversation.

Deleting the newest turn is simply a delete (it has no children), and deleting the oldest
correctly leaves its child at the head of the thread.

> [!NOTE]
>
> The same applies to a turn dropped by [`store: false`](https://docs.budecosystem.com/api-sdk/responses/create-response#what-store-false-guarantees):
> the eviction re-links the thread exactly as an explicit delete does.

## Supported Providers

`DELETE /v1/responses/{id}` is **provider-agnostic** — it applies to any response Bud stored,
whichever model produced it. Deleting a response the calling API key does not own returns
`404`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.