Devbox
Devbox-PersistenceTools

Synchronously create a disk snapshot of a running Devbox.

Changed on

Create a disk snapshot of a devbox with the specified name and metadata to enable launching future Devboxes with the same disk state.

post/v1/devboxes/{id}/snapshot_disk

Request

  • Base URL: https://api.runloop.ai
  • URL: https://api.runloop.ai/v1/devboxes/{id}/snapshot_disk
  • Auth: HTTP bearer

Path parameters

idstring required

The Devbox ID.

Request body

namestring nullable

(Optional) A user specified name to give the snapshot

metadataobject nullable

(Optional) Metadata used to describe the snapshot

commit_messagestring nullable

(Optional) Commit message associated with the snapshot (max 1000 characters)

Response

Snapshot created successfully.

idstring required

The unique identifier of the snapshot.

namestring nullable

(Optional) The custom name of the snapshot.

create_time_msinteger required

Creation time of the Snapshot (Unix timestamp milliseconds).

metadataobject required

User defined metadata associated with the snapshot.

source_devbox_idstring required

The source Devbox ID this snapshot was created from.

source_blueprint_idstring nullable

(Optional) The source Blueprint ID this snapshot was created from.

commit_messagestring nullable

(Optional) The commit message of the snapshot (max 1000 characters).

size_bytesinteger nullable

(Optional) The size of the snapshot in bytes, relative to the base blueprint.

Changes

  • e9dc776053e4Revision changes
    • info

      added the non-success response with the status

  • d3ddb452754cRevision changes
    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable