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

# Delete a Snapshot

> Remove a snapshot from the catalog

`DELETE /v1/agents/snapshots/{id_or_name}`

Deletes the snapshot. This cannot be undone. Sandboxes that already started from it keep running.

<CodeGroup>
  ```python Python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  from gravixlayer import GravixLayer

  client = GravixLayer()  # defaults to cloud="aws", region="us-east-1"

  result = client.snapshots.delete("after-warmup")
  print(result.deleted)
  ```

  ```typescript TypeScript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  import { GravixLayer } from 'gravixlayer';

  const client = new GravixLayer(); // defaults to cloud="aws", region="us-east-1"

  const result = await client.snapshots.delete("after-warmup");
  console.log(result.deleted);
  ```

  ```bash CLI theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  gravixlayer snapshot delete after-warmup -y
  ```

  ```bash cURL theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  # Requires: GRAVIXLAYER_API_KEY
  API="https://api.gravixlayer.ai/v1"

  curl -sS -X DELETE "$API/agents/snapshots/after-warmup" \
    -H "Authorization: Bearer $GRAVIXLAYER_API_KEY"
  ```
</CodeGroup>

The CLI asks for confirmation unless you pass `-y`.

## Notes

* You can pass the snapshot ID or name.
* After delete, `runtime.create(snapshot=...)` with that name fails.
* To stop new creates without deleting, [deactivate](/documentation/agentruntime/snapshots/activate-deactivate) instead.