Snapshot

List versioned backups

get

Returns all versioned backups for the authenticated user. Filter by appID or paginate results.

Authorizations

api-tokenstringRequired

Query parameters

pageinteger · min: 1Optional

Page number (must be >= 1)

Default: 1

limitinteger · min: 1 · max: 200Optional

Number of items per page (1–200)

Default: 50

summarybooleanOptional

If true, returns a summarized view of each backup

Default: false

appIDstring · max: 40Optional

Filter backups by a specific app ID (letters, numbers, hyphen; max 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

Responses

200

Backups retrieved successfully

application/json

statusstringOptionalExample: ok

messagestringOptional

400

Invalid parameter

application/json

401

Authentication error

application/json

404

No backups found for the given appID

application/json

500

Internal server error

application/json

get/snapshot

GET /v2/snapshot HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Backups retrieved successfully",
  "page": 1,
  "limit": 50,
  "total": 3,
  "backups": []
}

Generate backup download link

get

Generates a temporary download URL for a specific versioned backup.

Authorizations

api-tokenstringRequired

Path parameters

appIDstring · max: 40Required

App ID (letters, numbers, hyphen; max 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

versionstringRequired

Backup version in format YYYYMMDD-HHMMSS

Example: 20260420-153000Pattern: ^\d{8}-\d{6}$

Responses

200

Download link generated successfully

application/json

statusstringOptional

messagestringOptional

400

Invalid parameter

application/json

401

Authentication error

application/json

404

Backup version not found

application/json

500

Internal server error

application/json

get/snapshot/{appID}/versions/{version}

GET /v2/snapshot/{appID}/versions/{version} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Download link generated successfully",
  "app": {
    "id": "my-app-id"
  },
  "download": {
    "url": "https://storage.example.com/backup.zip?token=abc123",
    "expiresAt": "2026-04-21T15:30:00Z",
    "version": "20260420-153000",
    "size": 204800
  }
}

Delete a specific backup version

delete

Permanently deletes a specific versioned backup for an application.

Authorizations

api-tokenstringRequired

Path parameters

appIDstring · max: 40Required

App ID (letters, numbers, hyphen; max 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

versionstringRequired

Backup version in format YYYYMMDD-HHMMSS

Example: 20260420-153000Pattern: ^\d{8}-\d{6}$

Responses

200

Backup version deleted successfully

application/json

statusstringOptional

messagestringOptional

deletedstringOptional

400

Invalid parameter

application/json

401

Authentication error

application/json

403

Not the owner of this application

application/json

404

Application or version not found

application/json

500

Internal server error

application/json

delete/snapshot/{appID}/versions/{version}

DELETE /v2/snapshot/{appID}/versions/{version} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Backup version deleted successfully",
  "app": {
    "id": "my-app-id"
  },
  "deleted": "backups/123456/my-app-id/backup-my-app-id-20260420-153000.zip"
}

List backups for an app

get

Returns all versioned backups for a specific application.

Authorizations

api-tokenstringRequired

Path parameters

appIDstring · max: 40Required

App ID (letters, numbers, hyphen; max 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

Responses

200

Backups loaded successfully

application/json

statusstringOptional

messagestringOptional

versionsobject[]Optional

400

Invalid App ID format

application/json

401

Authentication error

application/json

404

No backups found for this app

application/json

500

Internal server error

application/json

get/snapshot/{appID}

GET /v2/snapshot/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Backups for this app were successfully loaded",
  "app": {
    "id": "my-app-id"
  },
  "versions": [
    {
      "version": "20260420-153000",
      "size": 204800,
      "date": 1745100000000
    }
  ]
}

Create versioned backup

post

Creates a new versioned backup (snapshot) for a specific application.

Authorizations

api-tokenstringRequired

Path parameters

appIDstring · max: 40Required

App ID (letters, numbers, hyphen; max 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

Responses

200

Versioned backup created successfully

application/json

statusstringOptional

messagestringOptional

400

Invalid appID format

application/json

401

Authentication error

application/json

403

Access denied — not the owner of this application, or plan does not allow versioned backups

application/json

404

Application not found

application/json

409

Application is busy processing another task

application/json

500

Internal server error

application/json

post/snapshot/{appID}

POST /v2/snapshot/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Versioned backup created successfully",
  "app": {
    "id": "my-app-id"
  },
  "snapshot": {
    "version": "20260420-153000",
    "size": "2.5 MB",
    "url": "https://s3.discloud.com/...",
    "allVersions": [
      {
        "version": "20260420-153000",
        "size": "2.5 MB",
        "date": "2026-04-20T15:30:00Z"
      }
    ]
  }
}