Get temporary download URL for backup
get
/v1/graphs/{graph_id}/backups/{backup_id}/downloadPart of Backup.
Generate a temporary download URL for a backup. The filename carries the extension listed as download_extension on the backup: .lbug.zip is a ZIP holding the LadybugDB database file {graph_id}.lbug; .lbug.zst (shared repository snapshots) is a single zstd-compressed database file. Decompress the latter with zstd -d <file>.lbug.zst (install zstd first: brew install zstd, apt-get install zstd, or dnf install zstd) — no --long flag is needed.
Authentication
Authenticate in any one of these ways — not all of them:
- API key in the
X-API-Keyheader. - Bearer token in the
Authorizationheader.
Path parameters
| Name | Type | Description |
|---|---|---|
backup_idrequired | string | Backup identifier |
graph_idrequired | string | Graph Id |
Query parameters
| Name | Type | Description |
|---|---|---|
expires_inoptional | integer | URL expiration time in seconds Default: |
Example request
curl
curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/backups/{backup_id}/download" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY"Responses
200 Download URL generated successfully
| Field | Type | Description |
|---|---|---|
download_urlrequired | string | Pre-signed S3 URL for downloading the backup file |
expires_inrequired | integer | URL expiration time in seconds from now |
expires_atrequired | number | Unix timestamp when the URL expires |
backup_idrequired | string | Backup identifier |
graph_idrequired | string | Graph database identifier |
| Status | Meaning |
|---|---|
| 403 | Access denied — admin role on the graph, or an eligible repository subscription, is required |
| 404 | Backup not found |
| 422 | Validation Error |
| 500 | Failed to generate download URL |