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 project across all engines. Lowercase letters, digits and hyphens work everywhere.

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 storage; storage above it is billed per GB per month ($0.15 today). Fixed on the free plan.

ha_enabled
boolean
default:false

Enable high availability (+70% of the plan price for PostgreSQL, Valkey and ClickHouse, +210% for MySQL, +140% for Kafka). Not available on the free plan.

replica_count
integer
default:0

Read replicas, PostgreSQL only. Each costs the same as the plan. Not available on the free plan.

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

Give the database a public address (TLS required) as soon as it is created. If the public address cannot be set up, the database is still created, without it; check public_access in the response of GET /api/v1/databases/{database_id}. Kafka is private only.

engine_config
object

Engine settings you can choose at create. Anything else is refused with 400.

  • Valkey maxmemory-policy: noeviction (default; nothing is ever removed, writes fail when memory is full; for queues and data you cannot lose) or allkeys-lru (the least recently used keys are removed when memory is full; for caches).
Example:
extensions
string[]

PostgreSQL only. Extensions to turn on before the database is marked running, so it is ready for them the moment you connect. Allowed: vector (AI embeddings), postgis, pg_cron, pg_trgm, pg_stat_statements, hstore, uuid-ossp, citext, ltree, pgcrypto, unaccent. Other engines or other names are refused with 400. Any other extension the image ships can be turned on later with the extensions endpoint.

Example:

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