Coolify Octri Demo
POST/databases/sqlite

Create a SQLite database

Creates a new SQLite database. Provide the database and environment details in the request body, including the required identifiers server_uuid, project_uuid, environment_name, and environment_uuid. Use image to specify the Docker image for the database.

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

18 body fields

Database configuration for the new SQLite database. The schema marks server_uuid, project_uuid, environment_name, and environment_uuid as required.

descriptionstringoptional
Description of the database
destination_uuidstringoptional
UUID of the destination if the server has multiple destinations
environment_namestringrequired
Name of the environment. You need to provide at least one of environment_name or environment_uuid.
environment_uuidstringrequired
UUID of the environment. You need to provide at least one of environment_name or environment_uuid.
imagestringoptional
Docker Image of the database
instant_deploybooleanoptional
Instant deploy the database
limits_cpu_sharesintegeroptional
CPU shares of the database
limits_cpusstringoptional
CPU limit of the database
limits_cpusetstringoptional
CPU set of the database
limits_memorystringoptional
Memory limit of the database
limits_memory_reservationstringoptional
Memory reservation of the database
limits_memory_swapstringoptional
Memory swap limit of the database
limits_memory_swappinessintegeroptional
Memory swappiness of the database
namestringoptional
Name of the database
project_uuidstringrequired
UUID of the project
server_uuidstringrequired
UUID of the server
sqlite_databasesstringoptional
Comma-separated SQLite database file names
tagsarray<string>optional
Tags to assign to the database.

4 status codes
200Returns the result of creating or updating the SQLite database.
400Returned when the request contains an invalid token.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
422Returned when the request fails validation.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned for an invalid token, a 401 when the request is unauthenticated, and a 422 when the request fails validation. The schema marks server_uuid, project_uuid, environment_name, and environment_uuid as required; the environment field descriptions say to provide at least one of the two environment identifiers.