{
  "opencollection": "1.0.0",
  "info": {
    "name": "Runloop agents Devbox-PersistenceTools API",
    "version": "0.1"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Devbox-PersistenceTools",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List disk snapshots of a Devbox.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots",
            "params": [
              {
                "name": "devbox_id",
                "value": "",
                "type": "query",
                "description": "Devbox ID to filter by."
              },
              {
                "name": "source_blueprint_id",
                "value": "",
                "type": "query",
                "description": "Source Blueprint ID to filter snapshots by."
              },
              {
                "name": "metadata[key]",
                "value": "",
                "type": "query",
                "description": "Filter snapshots by metadata key-value pair. Can be used multiple times for different keys."
              },
              {
                "name": "metadata[key][in]",
                "value": "",
                "type": "query",
                "description": "Filter snapshots by metadata key with multiple possible values (OR condition)."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "The limit of items to return. Default is 20. Max is 5000."
              },
              {
                "name": "starting_after",
                "value": "",
                "type": "query",
                "description": "Load the next page of data starting after the item with the given ID."
              },
              {
                "name": "include_total_count",
                "value": "",
                "type": "query",
                "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets."
              }
            ]
          },
          "docs": "List all snapshots of a Devbox while optionally filtering by Devbox ID, source Blueprint ID, and metadata."
        },
        {
          "info": {
            "name": "List public disk snapshots.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots/list_public",
            "params": [
              {
                "name": "devbox_id",
                "value": "",
                "type": "query",
                "description": "Devbox ID to filter by."
              },
              {
                "name": "source_blueprint_id",
                "value": "",
                "type": "query",
                "description": "Source Blueprint ID to filter snapshots by."
              },
              {
                "name": "metadata[key]",
                "value": "",
                "type": "query",
                "description": "Filter snapshots by metadata key-value pair. Can be used multiple times for different keys."
              },
              {
                "name": "metadata[key][in]",
                "value": "",
                "type": "query",
                "description": "Filter snapshots by metadata key with multiple possible values (OR condition)."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "The limit of items to return. Default is 20. Max is 5000."
              },
              {
                "name": "starting_after",
                "value": "",
                "type": "query",
                "description": "Load the next page of data starting after the item with the given ID."
              },
              {
                "name": "include_total_count",
                "value": "",
                "type": "query",
                "description": "If true (default), includes total_count in the response. Set to false to skip the count query for better performance on large datasets."
              }
            ]
          },
          "docs": "List all public disk snapshots that are available to all users."
        },
        {
          "info": {
            "name": "List available snapshot metadata keys.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots/metadata/keys"
          },
          "docs": "Returns a list of all available metadata keys that can be used for filtering snapshots."
        },
        {
          "info": {
            "name": "List values for a specific snapshot metadata key.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots/metadata/keys/:key/values",
            "params": [
              {
                "name": "key",
                "value": "",
                "type": "path",
                "description": "The metadata key to get values for."
              }
            ]
          },
          "docs": "Returns a list of all values that exist for a specific metadata key across all snapshots."
        },
        {
          "info": {
            "name": "List available public snapshot metadata keys.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots/public/metadata/keys"
          },
          "docs": "Returns a list of all available metadata keys from public snapshots only that can be used for filtering."
        },
        {
          "info": {
            "name": "List values for a specific public snapshot metadata key.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots/public/metadata/keys/:key/values",
            "params": [
              {
                "name": "key",
                "value": "",
                "type": "path",
                "description": "The metadata key to get values for from public snapshots."
              }
            ]
          },
          "docs": "Returns a list of all values that exist for a specific metadata key across all public snapshots only."
        },
        {
          "info": {
            "name": "Update metadata of Disk Snapshot.",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The Snapshot ID."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates disk snapshot metadata via update vs patch. The entire metadata will be replaced."
        },
        {
          "info": {
            "name": "Delete a disk snapshot of a Devbox.",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots/:id/delete",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The ID of the snapshot."
              }
            ]
          },
          "docs": "Delete a previously taken disk snapshot of a Devbox."
        },
        {
          "info": {
            "name": "Query the status of an asynchronous disk snapshot.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.runloop.ai/v1/devboxes/disk_snapshots/:id/status",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The Snapshot ID."
              }
            ]
          },
          "docs": "Get the current status of an asynchronous disk snapshot operation, including whether it is still in progress and any error messages if it failed."
        },
        {
          "info": {
            "name": "Synchronously create a disk snapshot of a running Devbox.",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.runloop.ai/v1/devboxes/:id/snapshot_disk",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The Devbox ID."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a disk snapshot of a devbox with the specified name and metadata to enable launching future Devboxes with the same disk state."
        },
        {
          "info": {
            "name": "Start an asynchronous disk snapshot of a running Devbox.",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.runloop.ai/v1/devboxes/:id/snapshot_disk_async",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The Devbox ID."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Start an asynchronous disk snapshot of a devbox with the specified name and metadata. The snapshot operation will continue in the background and can be monitored using the query endpoint."
        }
      ]
    }
  ],
  "bundled": true
}