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

# Parar aplicação

> Para uma aplicação pelo seu ID.

**id** `string` *required*

O ID da aplicação a parar. Se a aplicação pertencer a um workspace, informe o ID dele no query parameter `workspace_id`.

**workspace\_id** `string`

Se a aplicação pertencer a um workspace, o ID do workspace. Obrigatório para membros do workspace que agem sobre uma aplicação que não lhes pertence.

> [!NOTE]
>
> **Parar é idempotente.** Parar uma aplicação que já está parada é um sucesso, não um erro: a API responde `200` e garante que o estado registrado seja `down`. Você não precisa ler o status antes para decidir se a chamada é segura.

### Resposta

**response** `object`

A resposta com o status da operação.

**Mostrar objeto**

**status** `string`

O status da operação (`success`).

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

### Respostas de erro

**code** `string`

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

* `APP_NOT_FOUND`: a aplicação informada não existe.
* `ACCESS_DENIED`: o usuário não tem permissão para agir sobre a aplicação.
* `OPERATION_IN_PROGRESS`: outra operação de ciclo de vida na mesma aplicação já está em execução (`409`). O container não foi tocado — aguarde alguns segundos e tente de novo. Veja [Códigos de erro comuns](https://docs.vertracloud.app/pt-br/api-reference/introduction.md#quais-códigos-de-erro-a-api-pode-retornar).

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

> [!NOTE]
>
> Esta rota compartilha com `start` e `restart` um orçamento de 10 requisições por minuto por aplicação. Veja [Limite de requisições](https://docs.vertracloud.app/pt-br/api-reference/introduction.md#como-a-api-tem-limite-de-taxa).


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