Coolify Octri Demo
POST/services/{uuid}/storages/{storage_uuid}/backups/run

Run a service storage backup

Queues an immediate volume backup for a service storage that has a backup schedule. Use this operation to run a backup before its next scheduled execution; the token must have the write and deploy permissions.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters
uuidstringrequired
The UUID of the service whose storage backup you are running.
storage_uuidstringrequired
The UUID of the storage to back up.

4 status codes
200Returns confirmation that the storage backup was queued.
401Returned when the request is unauthenticated.
messagestringoptional
403Returned when the token lacks the write and deploy permissions.
404Returned when the service or storage resource is not found.
messagestringoptional

Error handling

A 401 indicates an unauthenticated request, a 403 indicates that the token lacks the write or deploy permission, and a 404 indicates that a resource was not found; the uuid path parameter and storage_uuid path parameter must identify the service and storage. The storage must have a backup schedule before you can queue an immediate backup.