Excluir banco de dados
curl --request DELETE \
--url https://api.vertracloud.app/v1/databases/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/databases/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/databases/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": "00000000000000000000000000000001"
}
Bancos de dados
Excluir banco de dados
Exclui um banco de dados pelo seu ID, depois de fazer um snapshot de segurança automático. Exige o escopo databases:delete.
DELETE
/
v1
/
databases
/
{id}
Excluir banco de dados
curl --request DELETE \
--url https://api.vertracloud.app/v1/databases/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/databases/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/databases/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": "00000000000000000000000000000001"
}
Antes de excluir um banco de dados, é feito automaticamente um snapshot de segurança, em todos os planos. Se esse snapshot falhar, nada é excluído e a requisição responde
SNAPSHOT_FAILED; entre em contato com o suporte. Uma chave de API precisa do escopo
databases:delete.
string
obrigatório
O ID do banco de dados a excluir.
string
Se o banco de dados pertencer a um workspace, o ID do workspace.
Resposta
string
O ID do banco de dados excluído.
{
"response": "00000000000000000000000000000001"
}
Respostas de erro
string
DATABASE_NOT_FOUND: O banco de dados não existe (404).ACCESS_DENIED: Sua conta não pode agir sobre este banco de dados (403).FORCED_SNAPSHOT_RATE_LIMIT: Muitos snapshots de segurança foram tentados recentemente neste banco de dados ou na sua conta; o banco de dados não foi excluído (429).SNAPSHOT_FAILED: Não foi possível fazer o snapshot de segurança; o banco de dados não foi excluído. Entre em contato com o suporte (500).OPERATION_IN_PROGRESS: Outra operação de ciclo de vida está em andamento neste banco de dados (409).INTERNAL_SERVER_ERROR: A plataforma não conseguiu remover o banco de dados; tente novamente mais tarde (500).
Última modificação em 28 de outubro de 2026