operationId: databases_add
summary: Add a New Database
description: |
To add a new database to an existing cluster, send a POST request to
`/v2/databases/$DATABASE_ID/dbs`.
Note: Database management is not supported for Caching or Valkey clusters.
The response will be a JSON object with a key called `db`. The value of this will be
an object that contains the standard attributes associated with a database.
tags:
- Databases
parameters:
- $ref: 'parameters.yml#/database_cluster_uuid'
requestBody:
required: true
content:
application/json:
schema:
$ref: 'models/database.yml'
example:
name: alpha
responses:
'201':
$ref: 'responses/database.yml'
'401':
$ref: '../../shared/responses/unauthorized.yml'
'404':
$ref: '../../shared/responses/not_found.yml'
'429':
$ref: '../../shared/responses/too_many_requests.yml'
'500':
$ref: '../../shared/responses/server_error.yml'
default:
$ref: '../../shared/responses/unexpected_error.yml'
x-codeSamples:
- $ref: 'examples/curl/databases_add.yml'
- $ref: 'examples/go/databases_add.yml'
- $ref: 'examples/python/databases_add.yml'
security:
- bearer_auth:
- 'database:create'