List Cloud VM backup runs in the workspace

GET

/compute/cloud-vm-backups/runs

GET

/v1/compute/cloud-vm-backups/runs

# Example request with curl (set IBEE_API_TOKEN to a platform API token and WORKSPACE_ID to the workspace first).
curl "https://api.ibee.ai/v1/compute/cloud-vm-backups/runs?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $IBEE_API_TOKEN"

{
  "runs": [
    {
      "organization_id": "<organization_id>",
      "workspace_id": "<workspace_id>",
      "run_id": "<run_id>",
      "vm_id": "<vm_id>",
      "trigger": "scheduled",
      "backup_type": "full",
      "status": "queued",
      "organization_name": "<organization_name>",
      "workspace_name": "<workspace_name>",
      "source_run_id": "<source_run_id>",
      "vm_backup_id": "<vm_backup_id>",
      "vm_type": "cloud",
      "vm_name": "<vm_name>",
      "os_type": "<os_type>",
      "os_distro": "<os_distro>",
      "template_id": "<template_id>",
      "policy_id": "<policy_id>",
      "chain_id": "<chain_id>",
      "recovery_point_id": "<recovery_point_id>",
      "storage_backend": "<storage_backend>",
      "started_at": "2026-10-25T12:00:00Z",
      "completed_at": "2026-10-25T12:00:00Z",
      "size_gb": 1,
      "source_disk_size_gb": 1,
      "bytes_transferred": 1,
      "backup_stored_size_bytes": 1,
      "backup_stored_size_gb": 1,
      "protected_storage_bytes": 1,
      "billing_storage_bytes": 1,
      "billing_storage_source": "unavailable",
      "metering_status": "unavailable",
      "captured_volume_count": 1,
      "root_only": true,
      "captured_topology_hash": "<captured_topology_hash>",
      "capture_scope": "root_only",
      "recovery_point_type": "backup",
      "volume_manifest": [],
      "volume_manifest_summary": {
        "root_only": true,
        "root_volume_name": "<root_volume_name>",
        "data_volume_names": [],
        "summary_text": "Root"
      },
      "live_drift_summary": {
        "drifted": false,
        "missing_from_live": [],
        "new_live_only": [],
        "message": "<message>"
      },
      "error_message": "<error_message>",
      "metadata": {}
    }
  ],
  "total": 0
}

Lists backup runs and recovery points of every Cloud VM in the workspace, as the portal’s Backups page does. Filter by vm_id or status. Requires scope: vm.read.

# Example request with curl (set IBEE_API_TOKEN to a platform API token and WORKSPACE_ID to the workspace first).
curl "https://api.ibee.ai/v1/compute/cloud-vm-backups/runs?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $IBEE_API_TOKEN"

Authentication

AuthorizationBearer

IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

vm_idstringOptional>=1 character

Return only runs of this VM.

statuslist of enumsOptional

Return only runs in these states. Repeat the parameter for several states.

Allowed values:

limitintegerOptional1-200Defaults to 50

Maximum number of records to return.

offsetintegerOptional>=0Defaults to 0

Number of items to skip before the first returned item. Default 0.

searchstringOptional>=1 character

Return only backup runs whose fields contain this text.

Response

Backup runs returned successfully.

runslist of objects

Backup runs on this page.

totalintegerDefaults to 0

Total number of runs matching the request.

Errors

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error