Criar snapshot da aplicação
curl --request POST \
--url https://api.vertracloud.app/v1/users/{id}/snapshots \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/users/{id}/snapshots', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/users/{id}/snapshots"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/users/{id}/snapshots"
req, _ := http.NewRequest("POST", 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": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"resource_id": "550e8400-e29b-41d4-a716-446655440001",
"type": 1,
"size": 1260,
"resource_name": "my-bot",
"created_at": "2026-09-16T15:00:00.000Z",
"expires_at": "2026-10-16T15:00:00.000Z"
}
}
Snapshots
Criar snapshot da aplicação
Faz um snapshot de uma aplicação ou do volume de um banco de dados agora. O snapshot aparece na lista e pode ser restaurado ou baixado como qualquer outro.
POST
/
v1
/
users
/
{id}
/
snapshots
Criar snapshot da aplicação
curl --request POST \
--url https://api.vertracloud.app/v1/users/{id}/snapshots \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/users/{id}/snapshots', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/users/{id}/snapshots"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/users/{id}/snapshots"
req, _ := http.NewRequest("POST", 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": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"resource_id": "550e8400-e29b-41d4-a716-446655440001",
"type": 1,
"size": 1260,
"resource_name": "my-bot",
"created_at": "2026-09-16T15:00:00.000Z",
"expires_at": "2026-10-16T15:00:00.000Z"
}
}
string
obrigatório
O ID da aplicação ou do banco de dados a ser salvo em snapshot.
string
obrigatório
O tipo do recurso. Valores possíveis:
applications, databases.Dois limites se aplicam aos snapshots manuais, além das 5 requisições por minuto da rota. O mesmo
recurso pode receber um snapshot a cada 5 minutos, e uma conta pode criar no máximo 10
snapshots por hora somando todos os seus recursos. Ao ultrapassar qualquer um dos limites, a API responde
429 SNAPSHOT_RATE_LIMITED com details.scope (resource ou account) e
details.retry_after em segundos. Os snapshots que a plataforma faz por conta própria (antes de um delete ou de um
reset) não contam. Veja Limite de requisições.Resposta
object
O snapshot criado.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O ID do recurso ao qual este snapshot pertence.
number
1 para uma aplicação, 2 para um banco de dados.number
Tamanho em kilobytes.
string | null
O nome que o recurso tinha no momento em que o snapshot foi feito.
string
Quando o snapshot foi feito.
string
Quando o snapshot será apagado automaticamente.
{
"response": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"resource_id": "550e8400-e29b-41d4-a716-446655440001",
"type": 1,
"size": 1260,
"resource_name": "my-bot",
"created_at": "2026-09-16T15:00:00.000Z",
"expires_at": "2026-10-16T15:00:00.000Z"
}
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: o headerAuthorizationestá ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: a chave de API é usada a partir de um IP fora da sua allowlist, ou não tem o escopo que a rota exige (403).USER_NOT_FOUND: o usuário autenticado não foi encontrado.APP_NOT_FOUND: a aplicação informada não existe.DATABASE_NOT_FOUND: o banco de dados informado não existe.ACCESS_DENIED: o usuário não é dono do recurso.PLAN_NOT_ALLOWED: o plano da conta não inclui snapshots manuais (403).DATABASE_NOT_RUNNING: o banco de dados precisa estar em execução para gerar um snapshot (409). O Redis não tem essa exigência.SNAPSHOT_RATE_LIMITED: o recurso recebeu um snapshot há menos de 5 minutos, ou a conta já criou 10 snapshots nesta hora (429). Vem comdetails.scopeedetails.retry_after.OPERATION_IN_PROGRESS: outra operação de ciclo de vida no mesmo recurso já está em execução (409). Nenhum snapshot foi feito — aguarde alguns segundos e tente de novo.INTERNAL_SERVER_ERROR: o snapshot não pôde ser armazenado, ou ocorreu uma falha inesperada (500). Tente de novo mais tarde.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "PLAN_NOT_ALLOWED"
}
{
"code": "SNAPSHOT_RATE_LIMITED",
"details": {
"scope": "resource",
"retry_after": 212
}
}
{
"code": "OPERATION_IN_PROGRESS"
}
{
"code": "DATABASE_NOT_RUNNING"
}
Última modificação em 28 de outubro de 2026