Provision a database

Hyze provisions PostgreSQL, MySQL, MongoDB, and Redis through the same API. The flow: create the instance, receive the connection string, inject it into your app.

Create the database

Choose an engine

postgresql, mysql, mongodb, or redis.

Create the instance

curl -X POST https://api.hyzecloud.com/api/databases/ \
  -H "Authorization: Bearer hyze_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-postgres",
    "engine": "postgresql",
    "memoryMB": 1024,
    "storageGB": 20
  }'

Store the connection string

Copy the connectionString from the response and save it as an app environment variable. Minimums: 256 MB memory and 1 GB storage.

Treat the connection string as a secret. Never commit it or paste it into logs.

Connect it to an app

curl -X PUT https://api.hyzecloud.com/api/apps/app_001/env \
  -H "Authorization: Bearer hyze_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "envVars": {
      "DATABASE_URL": "postgresql://user:pass@host:5432/db"
    }
  }'

Restart the app so the new variable gets injected.

Verify the result

Status: GET /api/databases/:databaseId — wait for status: running
Stats: GET /api/databases/:databaseId/stats

Common problems

The database is stuck in provisioning

Creation is asynchronous — the response carries an operationId. Track it with GET /api/databases/:databaseId/operations.

The app can't connect to the database

Confirm the app was restarted after receiving DATABASE_URL, and that the string points to the right instance.

I lost the database password

Rotate it with POST /api/databases/:databaseId/rotate-password and update the app’s variable.

Next steps

Back up a database

Protect data before risky changes.

Databases reference

Every endpoint in the database lifecycle.

Last modified on September 1, 2026

Deploy

Operate

Provision a database

Create the database

Connect it to an app

Verify the result

Common problems

Next steps

Back up a database

Databases reference

​Create the database

​Connect it to an app

​Verify the result

​Common problems

​Next steps

Back up a database

Databases reference

Create the database

Connect it to an app

Verify the result

Common problems

Next steps