POST
/
v1
/
organizations
/
{organizationName}
/
databases
curl -L -X POST 'https://api.turso.tech/v1/organizations/{organizationName}/databases' \
  -H 'Authorization: Bearer TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "new-database",
      "group": "default"
  }'
{
  "database": {
    "DbId": "0eb771dd-6906-11ee-8553-eaa7715aeaf2",
    "Hostname": "[databaseName]-[organizationName].turso.io",
    "Name": "my-db"
  }
}
curl -L -X POST 'https://api.turso.tech/v1/organizations/{organizationName}/databases' \
  -H 'Authorization: Bearer TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "new-database",
      "group": "default"
  }'

Path Parameters

organizationName
string
required

The name of the organization or user.

Body

application/json
name
string
required

The name of the new database. Must contain only lowercase letters, numbers, dashes. No longer than 64 characters.

group
string
required

The name of the group where the database should be created. The group must already exist.

seed
object
size_limit
string

The maximum size of the database in bytes. Values with units are also accepted, e.g. 1mb, 256mb, 1gb.

is_schema
boolean

Mark this database as the parent schema database that updates child databases with any schema changes. See Multi-DB Schemas.

schema
string

The name of the parent database to use as the schema. See Multi-DB Schemas.

Response

200 - application/json
database
object

The newly created database