> ## 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.

# Crear snapshot de la aplicación

> Toma ahora un snapshot del volumen de una aplicación o base de datos. Aparece en la lista y se puede restaurar o descargar como cualquier otro.

**id** `string` *required*

El ID de la aplicación o de la base de datos de la que tomar el snapshot.

**scope** `string` *required*

El tipo de recurso. Valores posibles: `applications`, `databases`.

> [!NOTE]
>
> **Se aplican dos límites a los snapshots manuales, además de las 5 peticiones por minuto de la ruta.** El mismo
> recurso solo puede tener un snapshot cada **5 minutos**, y una cuenta puede crear como máximo **10
> snapshots por hora** entre todos sus recursos. Si se supera cualquiera de los dos límites, la API responde
> `429 SNAPSHOT_RATE_LIMITED` con `details.scope` (`resource` o `account`) y
> `details.retry_after` en segundos. Los snapshots que toma la plataforma por su cuenta (antes de un borrado o de un reset) no cuentan. Consulta [Límite de peticiones](https://docs.vertracloud.app/es-es/api-reference/introduction.md#cómo-se-aplican-los-límites-de-peticiones-a-la-api).

### Respuesta

**response** `object`

El snapshot que se creó.

**Mostrar objeto**

**id** `string`

El ID del snapshot. Úsalo con [restaurar](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/snapshots/restore.md) y
[descargar](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/snapshots/download.md).

**resource\_id** `string`

El ID del recurso al que pertenece este snapshot.

**type** `number`

`1` para una aplicación, `2` para una base de datos.

**size** `number`

Tamaño en kilobytes.

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

El nombre que tenía el recurso en el momento en que se tomó el snapshot.

**created\_at** `string`

Cuándo se tomó el snapshot.

**expires\_at** `string`

Cuándo se eliminará automáticamente el snapshot.

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

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (`403`).
* `USER_NOT_FOUND`: No se encontró el usuario autenticado.
* `APP_NOT_FOUND`: La aplicación indicada no existe.
* `DATABASE_NOT_FOUND`: La base de datos indicada no existe.
* `ACCESS_DENIED`: El usuario no es propietario del recurso.
* `PLAN_NOT_ALLOWED`: El plan de la cuenta no incluye los snapshots manuales (`403`).
* `DATABASE_NOT_RUNNING`: La base de datos debe estar en ejecución para tomar un snapshot (`409`). Redis no tiene este requisito.
* `SNAPSHOT_RATE_LIMITED`: El recurso tiene un snapshot de hace menos de 5 minutos, o la cuenta ya creó 10 snapshots en esta hora (`429`). Viene con `details.scope` y `details.retry_after`.
* `OPERATION_IN_PROGRESS`: Otra operación de ciclo de vida sobre el mismo recurso ya está en curso (`409`). No se tomó ningún snapshot; espera unos segundos y vuelve a intentarlo.
* `INTERNAL_SERVER_ERROR`: No se pudo guardar el snapshot, o se produjo un fallo inesperado (`500`). Vuelve a intentarlo más tarde.

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

```json Error Response (403) theme={null}
{
  "code": "PLAN_NOT_ALLOWED"
}
```

```json Error Response (429) theme={null}
{
  "code": "SNAPSHOT_RATE_LIMITED",
  "details": {
    "scope": "resource",
    "retry_after": 212
  }
}
```

```json Error Response (409) theme={null}
{
  "code": "OPERATION_IN_PROGRESS"
}
```

```json Error Response (409) theme={null}
{
  "code": "DATABASE_NOT_RUNNING"
}
```


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