Get Application Snapshots

GET

users

{id}

snapshots

curl --request GET \
  --url https://api.vertracloud.app/v1/users/{id}/snapshots \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', 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));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/users/{id}/snapshots"

	req, _ := http.NewRequest("GET", 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",
      "size": "1.23 MB",
      "date": "2026-03-14T21:00:00.000Z",
      "resource_name": "api-staging"
    }
  ]
}

string

required

The ID of the application or database to retrieve snapshots for.

string

required

The resource type to filter snapshots by. Possible values: applications, databases.

Response

array

An array of snapshot objects.

Show Toggle object

string

The snapshot ID.

string

The ID of the resource this snapshot belongs to.

boolean

true for a snapshot of an application that came from a closed template. It cannot be downloaded, restores only into an application of the same template, and anything else answers TEMPLATE_CLOSED. Absent or false otherwise.

string

The formatted size of the snapshot (e.g. "1.23 MB").

string

The timestamp when the snapshot was created.

string | null

The name the resource had at the moment this snapshot was taken. Frozen: it does not follow later renames, and it survives the resource being deleted. null for snapshots taken before this field existed — no backfill was performed, since writing today’s name onto an old date would record something that was not true then.

{
  "response": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "resource_id": "550e8400-e29b-41d4-a716-446655440001",
      "size": "1.23 MB",
      "date": "2026-03-14T21:00:00.000Z",
      "resource_name": "api-staging"
    }
  ]
}

Error Responses

string

The error code indicating the reason for failure. Possible values:

AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: The Authorization header is missing, the API key is invalid, or the dashboard session was revoked (401).
API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: The API key is used from an IP outside its allowlist, or it lacks the scope the route requires (403).
USER_NOT_FOUND: The authenticated user was not found.
INTERNAL_SERVER_ERROR: An unexpected server error occurred.

{
  "code": "AUTH_TOKEN_MISSING"
}

{
  "code": "USER_NOT_FOUND"
}

Last modified on October 28, 2026

Get Application Snapshots

curl --request GET \
  --url https://api.vertracloud.app/v1/users/{id}/snapshots \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', 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));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/users/{id}/snapshots"

	req, _ := http.NewRequest("GET", 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",
      "size": "1.23 MB",
      "date": "2026-03-14T21:00:00.000Z",
      "resource_name": "api-staging"
    }
  ]
}

Overview

Endpoints

Get Application Snapshots

Response

Error Responses

​Response

​Error Responses

Response

Error Responses