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

# DELETE /v1/snapshots/{name} — Delete a snapshot template

> DELETE /v1/snapshots/{name} — Permanently delete a snapshot template by name. Removes files from disk and the database record. This cannot be undone.

Use this endpoint to permanently delete a snapshot template. The operation removes all snapshot files from disk and deletes the associated database record. This cannot be undone.

<Warning>
  Deleting a snapshot that capsules depend on will prevent those capsules from being resumed. If any paused capsule was created from this template, resuming it after deletion will fail. Verify that no paused capsules rely on this snapshot before deleting it.
</Warning>

## Endpoint

```http theme={null}
DELETE https://app.wrenn.dev/api/v1/snapshots/{name}
```

## Authentication

<ParamField header="X-API-Key" type="string" required>
  Your team's API key. Pass the full `wrn_...` key value.
</ParamField>

## Path parameters

<ParamField path="name" type="string" required>
  The name of the snapshot template to delete. This must exactly match the `name` field returned by `GET /v1/snapshots`.
</ParamField>

### Example request

```bash theme={null}
curl -X DELETE https://app.wrenn.dev/api/v1/snapshots/my-template \
  -H "X-API-Key: wrn_your_api_key_here"
```

## Response

Returns `204 No Content` on success. No body is returned.

## Python SDK

```python theme={null}
from wrenn import WrennClient

with WrennClient() as client:
    client.snapshots.delete("my-template")
```

## Error responses

| Status          | Meaning                                          |
| --------------- | ------------------------------------------------ |
| `404 Not Found` | No template with that name exists for your team. |