Coolify Octri Demo
POST/databases/{uuid}/restart

Restart a database

Restarts a database identified by its UUID. Use this operation to restart a database that is running. A restart cannot proceed while another start, restart, or import is in progress, or when the database is not ready to start.

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

1 parameter
uuidstringrequired
The UUID of the database to restart.

6 status codes
200Returns a message confirming that the database was restarted.
messagestringoptional
400Returned when the request contains an invalid token.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
404Returned when a resource is not found.
messagestringoptional
409Returned when another start, restart, or import of the database is already in progress.
422Returned when the database cannot start yet, for example because a CA certificate is missing.

Error handling

A 400 is returned for an invalid token, a 401 when the request is unauthenticated, and a 404 when the database resource is not found. A 409 indicates another start, restart, or import is in progress; a 422 indicates the database cannot start yet, such as when a CA certificate is missing. The uuid path parameter must identify the database to restart.