Skip to main content
Use this endpoint to provision a new managed database on Virtus Cloud. After a successful request, the API returns your database’s connection URL, password, and TLS certificate so you can connect immediately. Save the certificate to a .pem file for secure connections.

​
Request

POST https://api.virtuscloud.app/v2/databases

​
Headers

​
Authorization
string
required
Your Virtus Cloud API key. Pass it directly as the header value — no prefix required.Example: Authorization: vc_live_xxxxxxxxxxxx

​
Body

​
name
string
required
The display name for your database. Accepts alphanumeric characters (a–z, A–Z, 0–9).
​
memory
integer
required
RAM to allocate, in megabytes. Minimum is 512 MB for Redis and 1024 MB for MongoDB.
​
type
string
required
The database engine to use. Accepted values: mongo, redis.
​
version
string
required
The engine version to deploy. For example, 8.0.11 for MongoDB or 7.4.5 for Redis.

​
Response

​
status
string
Indicates whether the request succeeded. Returns "success" on a successful creation.
​
response
object
The newly created database object.
Store the password and certificate returned in this response — the password is not retrievable afterward, and the certificate can only be fetched separately via the credentials endpoint.

​
Examples

curl -X POST https://api.virtuscloud.app/v2/databases \
  -H "Authorization: <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "test",
    "memory": 1024,
    "type": "mongo",
    "version": "8.0.11"
  }'

​
Response Example

{
  "status": "success",
  "response": {
    "id": "a14b8d5e1cb7405a851eb4c075506121",
    "name": "test",
    "memory": 1024,
    "cpu": 2,
    "type": "mongo",
    "password": "XidqYaU154Bmq1qsNbDXORW2",
    "certificate": "QanBva1lveXMxCkpZcm9VZTRZcUZ3SW5CVTE2dFZzQnZSYy8wSk5PM25MRWNmUE03T3hxYzBPSzlrS1hNdjRHN2MyWTFXM0tnd1UKb3dWTXRmL3M1d1V1NVVvaVc3MVBaZz09Ci0tLS0tRU5EIFBSSVZBVEUgS0VZLS0tLS0KLS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURGVENDQWYyZ0F3SUJBZ0lVUktwRFV0aEhrVldnbkY5T1N6dHljOXVXRWZrd0RRWUpLb1pJaHZjTkFRRUwKQlFBd0dqRVlNQllHQTFVRUF3d1BLaTV6Y1hWaGNtVjNaV0l1WVhCd01CNFhEVEkxTURneE1qRTVOVFl5TUZvWApEVE0xTURneE1ERTVOVFl5TUZvd0dqRVlNQllHQTFVRUF3d1BLaTV6Y1hWaGNtVjNaV0l1WVhCd01JSUJJakFOCkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQXZTRjdCMmJVaEhRMzBocUtXYU9PZm5QR0ZNNWcKSlNEak5LZndObXhXUVRsNzlWdjJoTUxjbFljOHJxZUoxUVpsQ1gySFhrMFdENkxUcWxHbzFFVkt6dlMrTkxKUwp3SWF3elVUeUd4eGE0Q1gvUVh4Z2hpSGZjTUEvV0JFMU40UEZnRzBFLy8ySnNDMk43R3FvTW0yOXJEYU5wcEdhCkduTXdzeFcrdTgxR0pRTXl4RmFEVjVoZmlUOU52b1NnU0RLak9aaXV2TDFtZlBOck1WbzdQakF1RG5DSTk5T04KZk9QTC95ejNNbWJuMVJ5NzEwcktFeWhGY243TWtSU2RMbGpuSFlTaXJPdmw5NEdldUNXVjdMZENmdmVIV0wxOQprU3djYlRtSTUrV1BTY0NoKzRlM202empFcnJNTFlhZWFyMFlZTXlLK0tkcE5NVE1naXdGK1c0alh3SURBUUFCCm8xTXdVVEFkQmdOVkhRNEVGZ1FVOWIrODdIYVgrVG1ncEFRSXh2SGpGd1YzTkRZd0h3WURWUjBqQkJnd0ZvQVUKOWIrODdIYVgrVG1ncEFRSXh2SGpGd1YzTkRZd0R3WURWUjBUQVFIL0JBVXdBd0VCL3pBTkJna3Foa2lHOXcwQgpBUXNGQUFPQ0FRRUFpQUhmOGxiS2d3WDVxS1AyeTlnbk1ka3pOV2pTeW5MWnlKOXpnM0RoSXpLTTdrOEZBRkNlCnBndGd1eGZMSFhZMWxFWWhwYlUvSWlkSmUwRmRJMm00czV6QzYwT0hZM0FUYTNOVWJnby91NWllVWtaNlpzbkcKOUNETnlpeVJ0MnBXaFNwaUtvYTR4WXVoUWxQMkhDL2NCMU9sZ0pQSXlsUENKRWN1VkduMWd2WUZVK09vOGdXaQp5SzlRcDhKWVBSaUswQmJoRDRuL2ZBQjJLWnMrMmxyUU5xdmo0eUQ5WDR6VnhCSGV5MjkyYWEzMmY3bGhTSjFUCm8xR3BNSlVYSG1XQmxmNmFWRE5vQW9rWUlkYWxlSTFsaHFwQ3Uvc3FLUFV1am1WUm8vczBkUWdVNFRKeEZ3eCsKVGtXZXZqekQrOEFXU1dFaEZJVjQwU2xSVFNhdjJnYXFPZz09Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0K",
    "connection_url": "mongodb://default:XidqYaU154Bmq1qsNbDXORW2@virtuscloud-db-a14b8d5e1cb7405a851eb4c075506121.virtusapp.cloud:7015"
  }
}