Docs
Snapshots and forks ›

List snapshots

GET/v1/snapshots

Every snapshot you keep.

RequestTypeScript
  1. import { Agental } from "agental-sdk";
  2. const agental = new Agental();
  3. const snapshots = await agental.snapshots.list();
Answer200 OK
  1. {
  2. "snapshots": [{
  3. "id": string,
  4. "sandboxId": string,
  5. "name": string,
  6. "createdAt": string,
  7. "browsable": boolean,
  8. "size": string | null,
  9. … 1 more
  10. }],
  11. }

Every snapshot you keep, oldest first, of sandboxes that exist and of ones that were deleted.

Headers

Authorizationrequired
Bearer key
An API key that may make this call.

Returns

200 Every snapshot you keep, oldest first, of sandboxes that exist and of ones that were deleted.

JSON1 field
snapshots
Snapshot[]7 fields
id
string
sandboxId
string
name
string
createdAt
string
browsable
boolean
Whether the files in it can be listed and downloaded.
More False for a snapshot of the whole machine: roll back to it to reach them.
size
stringnull
The size of the sandbox it was taken of.
More A sandbox made from it gets this size unless another, with no less disk, is asked for.
sandboxDeleted
boolean
Whether the sandbox it was taken of has been deleted.
More The snapshot is kept either way, and a new sandbox can still be made from it.

Errors and other answers

404 Not found.

Every error answers { "error": { "code", "message" } }; a key without the action a call needs answers 403 key_action_forbidden, naming it.