Docs
Skip to content
post

Create database

Endpoint

posthttps://<REGION>.cloud.appwrite.io/v1/databases

Description

Create a new Database.

Required scopes

databases.write

Authentication

Initialize the Appwrite client with setProject() and a server API key (setKey()). For direct REST calls, send X-Appwrite-Project and X-Appwrite-Key.

Parameters

string
Required

Unique Id. Choose a custom ID or generate a random ID with ID.unique(). Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.

string
Required

Database name. Max length: 128 chars.

boolean

Is the database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.

Status
Content type
201
application/json

Database

Name
Type
Description
string

Database ID.

string

Database name.

string

Database creation date in ISO 8601 format.

string

Database update date in ISO 8601 format.

boolean

If database is enabled. Can be 'enabled' or 'disabled'. When disabled, the database is inaccessible to users, but remains accessible to Server SDKs using API keys.

legacy | tablesdb | documentsdb | vectorsdb

Database type.

DatabaseStatus

Database status. Possible values: provisioning, ready or failed

arrayof backup

Database backup policies.

Object type

arrayof Archive

Database backup archives.

Object type

Python
from appwrite.client import Client
from appwrite.services.databases import Databases
from appwrite.models import Database


client = Client()
client.set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
client.set_project('<YOUR_PROJECT_ID>') # Your project ID
client.set_key('<YOUR_API_KEY>') # Your secret API key


databases = Databases(client)


result: Database = databases.create(
    database_id = '<DATABASE_ID>',
    name = '<NAME>',
    enabled = False # optional
)


print(result.model_dump())