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

# List backups

> List an instance's available restore points, newest first.

<RequestExample>
  ```bash curl wrap theme={null}
  curl -X GET \
    https://api.agent37.com/v1/instances/ab12cd34ef/backups \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```python Python wrap theme={null}
  import requests

  response = requests.get(
      "https://api.agent37.com/v1/instances/ab12cd34ef/backups",
      headers={
          "Authorization": "Bearer sk_live_..."
      },
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript Node wrap theme={null}
  const response = await fetch(
    "https://api.agent37.com/v1/instances/ab12cd34ef/backups",
    {
      method: "GET",
      headers: {
        "Authorization": "Bearer sk_live_..."
      },
    },
  );
  if (!response.ok) {
    throw new Error(await response.text());
  }
  console.log(await response.json());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 wrap theme={null}
  {
    "data": [
      {
        "id": "9f3c1a7e2b4d6f8091a2",
        "kind": "manual",
        "created": 1789135331,
        "size_bytes": 412337102
      }
    ]
  }
  ```
</ResponseExample>

Authenticate with `Authorization: Bearer sk_live_...` on `https://api.agent37.com`.

## Path parameters

<ParamField path="id" type="string" required>
  The instance id, returned when you create an instance.
</ParamField>

## Behavior and errors

`GET /v1/instances/{id}/backups` returns every restore point, newest first: up to seven `automatic` backups and one `manual`.

A backup's `id` names that one copy. When a slot is overwritten, by the nightly rotation or by your next on-demand backup, its old id leaves the list and a restore of it returns `404 not_found`. `created` is when the backup was taken (unix seconds); `size_bytes` is the compressed size. Backups of a tree that has not changed hold the same bytes, so they share one id and list once: an idle or stopped instance can show a single record after seven nights.

See [Backups](/docs/agents-api/instance-backups) for retention and what is saved.


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