Skip to main content
POST
/
v1
/
organizations
/
{organizationSlug}
/
databases
curl -L -X POST 'https://api.turso.tech/v1/organizations/{organizationSlug}/databases' \
  -H 'Authorization: Bearer TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "new-database",
      "group": "default"
  }'

{
  "database": {
    "DbId": "<unknown>",
    "Hostname": "<unknown>",
    "Name": "<unknown>"
  }
}
curl -L -X POST 'https://api.turso.tech/v1/organizations/{organizationSlug}/databases' \
  -H 'Authorization: Bearer TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "new-database",
      "group": "default"
  }'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
organizationSlug
string
required

The slug of the organization or user account.

Body

application/json

Database data to create a new database

​
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.

​
remote_encryption
object

Encryption configuration for the database. Can be used when creating a new encrypted database, creating a encrypted database from upload (seed.type = "database_upload"), or forking from an encrypted database (required when the source database is encrypted).

Response

Successful response

​
database
object

The newly created database