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

# Detener la aplicación

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

**id** `string` *required*

El ID de la aplicación que quieres detener. 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.

> [!NOTE]
>
> **Detener es idempotente.** Detener una aplicación que ya está detenida es un éxito, no un error: la API responde `200` y se asegura de que el estado registrado sea `down`. No necesitas leer antes el estado para saber si la llamada es segura.

### 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.
* `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 `restart` un presupuesto de 10 peticiones por minuto por aplicación. 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.