Update Database
curl --request PUT \
--url https://api.vertracloud.app/v1/databases/{id} \
--header 'Content-Type: application/json' \
--data '{
"updates": {}
}'import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
payload = { "updates": {} }
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({updates: {}})
};
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([
'updates' => [
]
]),
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 \"updates\": {}\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 \"updates\": {}\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 \"updates\": {}\n}"
response = http.request(request)
puts response.read_body{
"response": {
"id": "639d9aa35d8b4e559bcd066db4ddcc8c",
"cluster": 1,
"type": 1,
"name": "UpdatedDatabase",
"description": "Updated description",
"owner_id": "993591427428790342",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "639d9aa35d8b4e559bcd066db4ddcc8c.db.usa1.vertraweb.app",
"port": 12748,
"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 or description of a specific 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 '{
"updates": {}
}'import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
payload = { "updates": {} }
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({updates: {}})
};
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([
'updates' => [
]
]),
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 \"updates\": {}\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 \"updates\": {}\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 \"updates\": {}\n}"
response = http.request(request)
puts response.read_body{
"response": {
"id": "639d9aa35d8b4e559bcd066db4ddcc8c",
"cluster": 1,
"type": 1,
"name": "UpdatedDatabase",
"description": "Updated description",
"owner_id": "993591427428790342",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "639d9aa35d8b4e559bcd066db4ddcc8c.db.usa1.vertraweb.app",
"port": 12748,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T20:00:00Z"
}
}
The ID of the database to update.
The fields to update for the database.
Show Toggle object
Show Toggle object
Response
The updated details of the database.
Show Toggle object
Show Toggle object
The ID of the database.
The cluster ID where the database is hosted.
The type of the database.
The name of the database.
The description of the database.
The ID of the database owner.
The ID of the owner’s plan.
The status of the database (e.g.,
up).The RAM allocated to the database in MB.
The host address of the database.
The port used by the database.
The timestamp of the last snapshot, if available.
The timestamp when the database was created.
The timestamp when the database was last updated.
{
"response": {
"id": "639d9aa35d8b4e559bcd066db4ddcc8c",
"cluster": 1,
"type": 1,
"name": "UpdatedDatabase",
"description": "Updated description",
"owner_id": "993591427428790342",
"owner_plan_id": 1,
"status": "up",
"ram": 256,
"host": "639d9aa35d8b4e559bcd066db4ddcc8c.db.usa1.vertraweb.app",
"port": 12748,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T20:00:00Z"
}
}
Error Responses
The error code indicating the reason for failure. Possible values:
UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.DATABASE_NOT_FOUND_OR_FORBIDDEN: The specified database does not exist or the user lacks access.INVALID_NAME: The provided name is invalid.INVALID_DESCRIPTION: The provided description is invalid.
A descriptive message providing additional details about the error.
{
"code": "UNAUTHORIZED"
}
{
"code": "DATABASE_NOT_FOUND_OR_FORBIDDEN"
}
{
"code": "INVALID_NAME"
}
⌘I