> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter snapshots da aplicação

> Retorna a lista de snapshots de uma aplicação ou banco de dados específico.

**id** `string` *required*

O ID da aplicação ou do banco de dados cujos snapshots serão retornados.

**scope** `string` *required*

O tipo do recurso para filtrar os snapshots. Valores possíveis: `applications`, `databases`.

### Resposta

**response** `array`

Um array de objetos de snapshot.

**Mostrar objeto**

**id** `string`

O ID do snapshot.

**resource\_id** `string`

O ID do recurso ao qual este snapshot pertence.

**closed** `boolean`

`true` para um snapshot de uma aplicação que veio de um template fechado. Ele não pode ser baixado, só é restaurado em uma aplicação do mesmo template, e qualquer outra tentativa responde `TEMPLATE_CLOSED`. Ausente ou `false` nos demais casos.

**size** `string`

O tamanho formatado do snapshot (por exemplo, `"1.23 MB"`).

**date** `string`

O timestamp de quando o snapshot foi criado.

**resource\_name** `string | null`

O nome que o recurso tinha no momento em que este snapshot foi feito. Congelado: não acompanha
renomeações posteriores, e sobrevive à exclusão do recurso. `null` para snapshots feitos antes
de este campo existir — não houve preenchimento retroativo, já que gravar o nome de hoje em uma
data antiga registraria algo que não era verdade naquela época.

```json Response theme={null}
{
  "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"
    }
  ]
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: o header `Authorization` está 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.
* `INTERNAL_SERVER_ERROR`: ocorreu um erro inesperado no servidor.

```json Error Response (401) theme={null}
{
  "code": "AUTH_TOKEN_MISSING"
}
```

```json Error Response (401) theme={null}
{
  "code": "USER_NOT_FOUND"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.