Skip to main content
POST
https://api.vertracloud.app
/
v1
/
apps
/
{id}
/
backups
/
{backup_id}
/
restore
Restore Application Backup
curl --request POST \
  --url https://api.vertracloud.app/v1/apps/{id}/backups/{backup_id}/restore
{
  "status": "success",
  "response": {
    "id": "v111d4af8cd74272a284831fbae14a8v",
    "owner_id": "993591427428790342",
    "owner_plan_id": 1,
    "name": "Simple API",
    "description": "I have a description :)",
    "cluster": 1,
    "status": "up",
    "ram": 128,
    "type": 2,
    "language": "nodejs",
    "subdomain": "myapp.vertraweb.app",
    "custom_domain": null,
    "created_at": "2025-08-14T19:58:00Z",
    "updated_at": "2025-08-14T19:58:00Z",
    "last_commit": "2025-08-14T19:58:00Z",
    "last_backup": "2025-08-14T19:58:00Z"
  }
}
​
id
string
required
The ID of the application to restore the backup to. If the application belongs to an organization, include the organization ID in the format appId-orgId.
​
backup_id
string
required
The ID of the backup to restore.

​
Response

​
status
string
Indicates whether the call was successful. success if successful, error if not.
​
response
object
Details of the restored application.
{
  "status": "success",
  "response": {
    "id": "v111d4af8cd74272a284831fbae14a8v",
    "owner_id": "993591427428790342",
    "owner_plan_id": 1,
    "name": "Simple API",
    "description": "I have a description :)",
    "cluster": 1,
    "status": "up",
    "ram": 128,
    "type": 2,
    "language": "nodejs",
    "subdomain": "myapp.vertraweb.app",
    "custom_domain": null,
    "created_at": "2025-08-14T19:58:00Z",
    "updated_at": "2025-08-14T19:58:00Z",
    "last_commit": "2025-08-14T19:58:00Z",
    "last_backup": "2025-08-14T19:58:00Z"
  }
}

​
Error Responses

​
status
string
Indicates whether the call was successful. error if not successful.
​
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.
  • FORBIDDEN: The user does not have permission to access the application.
  • APP_NOT_FOUND: The specified application does not exist.
  • BACKUP_NOT_FOUND: The specified backup does not exist.
  • BACKUP_DATA_NOT_FOUND: The backup data could not be retrieved.
  • INVALID_LANGUAGE: The programming language could not be detected.
  • NO_CONFIG_FILE: The backup does not contain a configuration file.
  • INVALID_CONFIG: The configuration file is invalid.
  • INVALID_MEMORY: The requested memory is invalid or exceeds plan limits.
  • FAILED_TO_RESTORE_BACKUP: The backup restoration failed.
  • FAILED_TO_REBUILD_APP: The application could not be rebuilt after restoration.
  • OWNER_APP_WITHOUT_LIMITS: The owner’s plan limits could not be found.
{
  "status": "error",
  "code": "UNAUTHORIZED"
}