---
title: "Create a database"
method: POST
path: "/v0/api/databases"
tags: ["Databases"]
---

# Create a database

`POST /v0/api/databases`

## Request

- Base URL: `https://api.anything.com`
- URL: `https://api.anything.com/v0/api/databases`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/anything/apis/anything-api/docs/v0/api/databases/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new user database. The database is provisioned asynchronously — poll GET /databases/{databaseId} until the status leaves CREATING.

## Request body

- object
  - `organizationId` string, uuid, required
  - `projectGroupId` string, uuid, nullable
  - `name` string, nullable

## Response `201`

Database creation started

- object
  - `database` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `status` 'CREATING' | 'COMPLETED' | 'FAILED', required
    - `organizationId` string, uuid, required
    - `organizationName` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `pointInTimeRestoreEnabled` boolean, required

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found — the referenced resource does not exist (including malformed resource IDs)

---

[API](https://skmtc.dev/anything/apis/anything-api.md) - [All operations](https://skmtc.dev/anything/apis/anything-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anything/apis/anything-api/revisions/1475488f3446?raw)