Update Database
curl --request PUT \
--url https://api.vertracloud.app/v1/databases/{id} \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"description": {},
"ram": 123
}
'import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
payload = {
"name": "<string>",
"description": {},
"ram": 123
}
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', description: {}, ram: 123})
};
fetch('https://api.vertracloud.app/v1/databases/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vertracloud.app/v1/databases/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'description' => [
],
'ram' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/databases/{id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"description\": {},\n \"ram\": 123\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.vertracloud.app/v1/databases/{id}")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"description\": {},\n \"ram\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/databases/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"description\": {},\n \"ram\": 123\n}"
response = http.request(request)
puts response.read_body{
"response": {
"id": "00000000000000000000000000000001",
"cluster": 1,
"type": 1,
"name": "UpdatedDatabase",
"description": "Updated description",
"owner_id": "123456789012345678",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "database.example.com",
"port": 5432,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T20:00:00Z"
}
}
Databases
Update Database
Updates the name, description or RAM of a database by its ID.
PUT
/
v1
/
databases
/
{id}
Update Database
curl --request PUT \
--url https://api.vertracloud.app/v1/databases/{id} \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"description": {},
"ram": 123
}
'import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
payload = {
"name": "<string>",
"description": {},
"ram": 123
}
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', description: {}, ram: 123})
};
fetch('https://api.vertracloud.app/v1/databases/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vertracloud.app/v1/databases/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'description' => [
],
'ram' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/databases/{id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"description\": {},\n \"ram\": 123\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.vertracloud.app/v1/databases/{id}")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"description\": {},\n \"ram\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/databases/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"description\": {},\n \"ram\": 123\n}"
response = http.request(request)
puts response.read_body{
"response": {
"id": "00000000000000000000000000000001",
"cluster": 1,
"type": 1,
"name": "UpdatedDatabase",
"description": "Updated description",
"owner_id": "123456789012345678",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "database.example.com",
"port": 5432,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T20:00:00Z"
}
}
string
required
The ID of the database to update.
string
If the database belongs to a workspace, the workspace’s ID.
string
The new name for the database. 1 to 50 characters.
string | null
The new description, up to 128 characters. An empty string or
null clears it.number
The new RAM in MB, a positive integer. It must fit in the plan’s free memory and respect the
engine’s minimum (512 MB for Redis, 1024 MB for the others).
Response
object
The updated details of the database.
Show Toggle object
Show Toggle object
string
The ID of the database.
number
The database cluster ID.
number
The type of the database.
string
The name of the database.
string
The description of the database.
string
The ID of the database owner.
number
The owner’s plan ID.
string
The status of the database (e.g.,
up).number
The RAM allocated to the database in MB.
string
The host address of the database.
number
The port used by the database.
string | null
The timestamp of the last snapshot, if available.
string
The timestamp when the database was created.
string
The timestamp when the database was last updated.
{
"response": {
"id": "00000000000000000000000000000001",
"cluster": 1,
"type": 1,
"name": "UpdatedDatabase",
"description": "Updated description",
"owner_id": "123456789012345678",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "database.example.com",
"port": 5432,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T20:00:00Z"
}
}
Error Responses
string
The error code indicating the reason for failure. Possible values:
VALIDATION_ERROR: A body or query field failed validation (400).INVALID_RAM_LIMIT: The requested RAM is outside what the engine and plan allow (400).MEMORY_LIMIT_EXCEEDED: The plan doesn’t have enough free memory for the new RAM (400).ACCESS_DENIED: Your account can’t act on this database (403).DATABASE_NOT_FOUND: The database does not exist (404).OPERATION_IN_PROGRESS: Another lifecycle operation is running on this database (409).
{
"code": "DATABASE_NOT_FOUND"
}