> ## 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 aplicação

> Reinicia uma aplicação pelo seu ID.

**id** `string` *required*

O ID da aplicação a reiniciar. 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.

Quando a linguagem da aplicação foi alterada, as dependências da linguagem anterior são removidas automaticamente no restart.

**reinstall\_dependencies** `boolean`

Opcional. Reinstala as dependências da aplicação do zero, ignorando o cache de instalação — equivalente a "Reinstalar Dependências" no gerenciador de arquivos do painel. Use quando uma pasta de dependências estiver corrompida ou quando um pacote foi instalado manualmente e precisa sair. Conta no limite horário de deploy do seu plano.

**force\_build** `boolean`

Opcional. Roda o comando de build da aplicação de novo, mesmo que nenhum arquivo de código tenha mudado desde o último build — equivalente a "Forçar build" no painel. Só faz sentido quando a aplicação tem um comando de build. Conta no limite horário de deploy do seu plano.

### 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.
* `DEPLOY_RATE_LIMITED`: `reinstall_dependencies` ou `force_build` foi enviado e o limite horário de deploy do plano se esgotou (`429`); `details` traz `limit`, `window_seconds` e `retry_after`.
* `PLAN_REQUIRED`: a conta dona da aplicação não tem um plano ativo (`403`). Assine um plano para continuar.
* `APP_SHIELD_COOLDOWN`: a Vertra Shield pausou a aplicação; esta ação fica bloqueada até a pausa terminar (`403`). `details.until` informa quando.
* `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 `stop` um orçamento de 10 requisições por minuto por aplicação. Com `reinstall_dependencies` ou `force_build`, ela também consome um slot do limite horário de deploy do seu plano. 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.