curl -X GET \
https://api.agent37.com/v1/instances/ab12cd34ef/backups \
-H "Authorization: Bearer sk_live_..."
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())
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());
{
"data": [
{
"id": "9f3c1a7e2b4d6f8091a2",
"kind": "manual",
"created": 1789135331,
"size_bytes": 412337102
}
]
}
Backups
List backups
List an instance’s available restore points, newest first.
GET
/
v1
/
instances
/
{id}
/
backups
curl -X GET \
https://api.agent37.com/v1/instances/ab12cd34ef/backups \
-H "Authorization: Bearer sk_live_..."
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())
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());
{
"data": [
{
"id": "9f3c1a7e2b4d6f8091a2",
"kind": "manual",
"created": 1789135331,
"size_bytes": 412337102
}
]
}
curl -X GET \
https://api.agent37.com/v1/instances/ab12cd34ef/backups \
-H "Authorization: Bearer sk_live_..."
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())
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());
{
"data": [
{
"id": "9f3c1a7e2b4d6f8091a2",
"kind": "manual",
"created": 1789135331,
"size_bytes": 412337102
}
]
}
Authorization: Bearer sk_live_... on https://api.agent37.com.
Path parameters
string
required
The instance id, returned when you create an instance.
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 for retention and what is saved.