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

# Reiniciar la aplicación

> Reinicia una aplicación a partir de su ID.

**id** `string` *required*

El ID de la aplicación que quieres reiniciar. Si la aplicación pertenece a un workspace, pasa su ID en el parámetro de consulta `workspace_id`.

**workspace\_id** `string`

Si la aplicación pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúen sobre una aplicación que no les pertenece.

Cuando cambia el lenguaje de la aplicación, las dependencias del lenguaje anterior se eliminan automáticamente en el reinicio.

**reinstall\_dependencies** `boolean`

Opcional. Vuelve a instalar las dependencias de la aplicación desde cero, ignorando la caché de instalación; equivale a "Reinstall dependencies" en el gestor de archivos del panel. Úsalo cuando una carpeta de dependencias esté dañada o cuando un paquete se instaló a mano y hay que quitarlo. Cuenta para el límite horario de despliegues de tu plan.

**force\_build** `boolean`

Opcional. Ejecuta de nuevo el comando de build de la aplicación aunque no haya cambiado ningún archivo fuente desde el último build; equivale a "Force build" en el panel. Solo tiene sentido cuando la aplicación tiene un comando de build. Cuenta para el límite horario de despliegues de tu plan.

### Respuesta

**response** `object`

La respuesta con el estado de la operación.

**Mostrar objeto**

**status** `string`

El estado de la operación (`success`).

```json Response theme={null}
{
  "response": {
    "status": "success"
  }
}
```

### Respuestas de error

**code** `string`

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

* `APP_NOT_FOUND`: La aplicación indicada no existe.
* `ACCESS_DENIED`: El usuario no tiene permiso para actuar sobre la aplicación.
* `DEPLOY_RATE_LIMITED`: Se envió `reinstall_dependencies` o `force_build` y se agotó el límite horario de despliegues del plan (`429`); `details` incluye `limit`, `window_seconds` y `retry_after`.
* `PLAN_REQUIRED`: La cuenta propietaria de la aplicación no tiene un plan activo (`403`). Contrata un plan para continuar.
* `APP_SHIELD_COOLDOWN`: Vertra Shield pausó la aplicación; esta acción queda bloqueada hasta que termine la pausa (`403`). `details.until` indica cuándo.
* `OPERATION_IN_PROGRESS`: Otra operación de ciclo de vida sobre la misma aplicación ya está en curso (`409`). El contenedor no se tocó; espera unos segundos y vuelve a intentarlo. Consulta [Códigos de error comunes](https://docs.vertracloud.app/es-es/api-reference/introduction.md#qué-códigos-de-error-puede-devolver-la-api).

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

> [!NOTE]
>
> Esta ruta comparte con `start` y `stop` un presupuesto de 10 peticiones por minuto por aplicación. Con `reinstall_dependencies` o `force_build`, también consume un slot del límite horario de despliegues de tu plan. 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).


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