Skip to main content
POST
Create database

Authorizations

X-API-Key
string
header
required

API key for authentication. Each key is bound to a specific account.

Headers

X-Project-ID
string<uuid>
required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Body

application/json
name
string
required

Display name, unique within the account

Example:

"orders-db"

plan_id
integer
required

Pricing plan ID from GET /api/v1/databases/plans

Example:

5

engine
enum<string>

Database engine identifier. Defaults to postgres on create; the live catalog (including availability and versions) is GET /api/v1/databases/engines.

Available options:
postgres,
mysql,
valkey,
clickhouse,
kafka
Example:

"postgres"

engine_version
string

Engine major version from the engine catalog. Omit for the default version.

Example:

"16"

storage_gb
integer

Storage in GB. Omit to use the plan's included allotment; storage above it bills at $0.12/GB/month.

ha_enabled
boolean
default:false

Enable high availability (+70% of the plan price)

replica_count
integer
default:0

Read replicas (PostgreSQL only; Valkey rejects a count above 0)

region
enum<string>
default:us-east

Data center region

Available options:
us-east
vpc_id
string<uuid>

VPC to place the private endpoint in. Omit to create without VPC connectivity and attach one later via POST /api/v1/databases/{database_id}/vpc.

public_access
boolean
default:false

Enable public access at create time

engine_config
object

Engine configuration overrides (allowlisted keys only)

Response

Database created (status pending while provisioning)

success
boolean
database
object

A managed database instance. The private endpoint {database_id}.db.raffusercloud.com lives inside the attached VPC; public access is optional. TLS is always required.

Last modified on October 5, 2026