> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Iniciar aplicação

> Inicie uma aplicação parada com POST /v2/apps/{app_id}/start. Retorna 409 quando ela já está em execução, e nunca faz deploy de código novo.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `apps:control`.

Inicia uma aplicação parada no cluster designado a ela. Se a aplicação já estiver em execução, a requisição responde `409 CONTAINER_ALREADY_STARTED` em vez de não fazer nada, então verifique [Obter status da aplicação](/pt-br/api-reference/endpoint/apps/status) antes ou trate esse código como sucesso em scripts.

Iniciar apenas coloca os arquivos e a configuração existentes online, não faz deploy de código novo; use [Enviar aplicação](/pt-br/api-reference/endpoint/apps/upload) para um primeiro deploy ou [Enviar commit da aplicação](/pt-br/api-reference/endpoint/apps/commit) para enviar uma alteração antes. Em aplicações compartilhadas em workspace, quem chama precisa da [função](/pt-br/api-reference/endpoint/workspace/members/invite#funções) `manager`, `maintain` ou `admin`.

A requisição possui limite de taxa de 1 início a cada 3 segundos por aplicação, e de 20 ações de ciclo de vida a cada 15 segundos por usuário somando todas as aplicações, com um bloqueio curto ao atingir esse limite. A requisição também é rejeitada com `403 RESTORE_IN_PROGRESS` enquanto uma restauração de snapshot está em andamento na aplicação (até cerca de 2 minutos): aguarde a restauração terminar e tente de novo.

## Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
      "status": "success"
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `RESTORE_IN_PROGRESS` | 403 | Uma restauração de snapshot está em andamento nesta aplicação; aguarde até terminar (até cerca de 2 minutos). |
| `CONTAINER_ALREADY_STARTED` | 409 | A aplicação já está em execução. |
| `ACTION_FAILED` | 409 | O cluster rejeitou a ação, por exemplo se a aplicação está em meio a um deploy. |

## Relacionados

* CLI: [`squarecloud app start`](/pt-br/cli-reference/apps#squarecloud-app-start)
* SDKs: [`api.apps.start()`](/pt-br/sdks/js/managing_application) (JavaScript), [`client.apps.start()`](/pt-br/sdks/py/managing_application) (Python), [`c.Apps.Start()`](/pt-br/sdks/go/managing_application) (Go)


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