Skip to content

List saved snapshots

View .md
GET

This project's saved snapshots, newest first.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Query parameters

  • limitinteger
    Default50
    Limitsmax 100
  • cursorstring

Responses

200Snapshots.
  • itemsobject[]required
    11 properties
    • idstringrequired
    • namestringrequired
    • statusstringrequired
      • saving: the disk is being captured. It cannot be started from or deleted yet.
      • ready: start sandboxes from it with from.
      • failed: the save did not finish; its first day was refunded. See failureReason.
      One ofsavingreadyfailed
    • sizestringrequired

      Machine size, and its price per hour of machine time: - small: 2 vCPU, 4 GB RAM. $0.0225/h. - default: 4 vCPU, 8 GB RAM. $0.045/h. - large: 8 vCPU, 16 GB RAM. $0.09/h.

      One ofsmalldefaultlarge
    • sizeBytesintegernullable

      Bytes on disk, once known.

    • sourceSandboxIdstringrequired

      The sandbox whose disk this is.

    • shareCodestringrequirednullable

      The code another team passes as from to start from this snapshot, while it is shared. Null when it is not. Treat it as a secret: whoever holds it can copy this disk.

    • costTotalnumberrequired

      USD charged for it so far.

    • failureReasonstringnullable
    • createdAtstring<date-time>required
    • updatedAtstring<date-time>required
  • nextCursorstringnullable
400Invalid query parameters.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject