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

# Listar deploys

> Liste os deploys recentes via Git de uma aplicação com GET /v2/apps/{app_id}/deployments, com cada estado, de pending a success, ou o código de erro.

<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:read`.

Use este endpoint para inspecionar o que aconteceu durante os deploys recentes: cada array interno captura o ciclo de vida de uma tentativa de deploy, passando pelos estados `pending`, `clone`, `commit`, `restarting` e `success`. Um deploy que falha termina em um evento `error` que carrega um `code` (por exemplo `AUTHENTICATION_REQUIRED`, `INVALID_BRANCH` ou `CLONE_FAILED`) e, às vezes, uma `message` com detalhes. Não existe um estado `failed`.

Apenas deploys via Git, de um [webhook](/pt-br/api-reference/endpoint/apps/deploy/webhooks) ou de um push do [GitHub App](/pt-br/api-reference/endpoint/apps/deploy/github-app-link), são registradas, então o `source` de todo evento é `git`. Uploads de zip e chamadas a [Enviar commit da aplicação](/pt-br/api-reference/endpoint/apps/commit) não aparecem aqui.

O registro de deploys vem de um cache de curta duração no cluster, então ele reflete apenas a atividade mais recente da aplicação e retorna um array vazio quando não há mais nada registrado. Para verificar a integração Git configurada atualmente em vez das tentativas de deploy anteriores, veja [Obter o deploy atual](/pt-br/api-reference/endpoint/apps/deploy/info).

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

<ResponseField name="response" type="array">
  O conteúdo da resposta.

  <Expandable title="Alternar objeto">
    <ResponseField name="id" type="string">
      O ID do deploy.
    </ResponseField>

    <ResponseField name="state" type="string">
      O estado do deploy: `pending`, `clone`, `commit`, `restarting`, `success` ou `error`.
    </ResponseField>

    <ResponseField name="date" type="string">
      A data do evento.
    </ResponseField>

    <ResponseField name="source" type="string">
      Sempre `git`.
    </ResponseField>

    <ResponseField name="code" type="string">
      Apenas em eventos `error`: o motivo da falha do deploy, por exemplo `AUTHENTICATION_REQUIRED`, `INVALID_BRANCH` ou `CLONE_FAILED`.
    </ResponseField>

    <ResponseField name="message" type="string">
      Apenas em alguns eventos `error`: detalhes sobre a falha.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
      "status": "success",
      "response": [
          [
              { "id": "96b1c6931c20b1555e612d3c8cd0a7b36f0fd5c7", "state": "pending", "date": "2026-05-28T21:47:33.608Z", "source": "git" },
              { "id": "96b1c6931c20b1555e612d3c8cd0a7b36f0fd5c7", "state": "clone", "date": "2026-05-28T21:47:34.019Z", "source": "git" },
              { "id": "96b1c6931c20b1555e612d3c8cd0a7b36f0fd5c7", "state": "commit", "date": "2026-05-28T21:47:36.240Z", "source": "git" },
              { "id": "96b1c6931c20b1555e612d3c8cd0a7b36f0fd5c7", "state": "restarting", "date": "2026-05-28T21:47:37.105Z", "source": "git" },
              { "id": "96b1c6931c20b1555e612d3c8cd0a7b36f0fd5c7", "state": "success", "date": "2026-05-28T21:47:41.872Z", "source": "git" }
          ]
      ]
  }
  ```
</ResponseExample>

## Relacionados

* CLI: [`squarecloud app deploy list`](/pt-br/cli-reference/github-deploys#squarecloud-app-deploy-list)
* SDKs: [`api.apps.deploys.list()`](/pt-br/sdks/js/deploys) (JavaScript), [`client.apps.deploys.list()`](/pt-br/sdks/py/deploys) (Python), [`c.Apps.Deploys.List()`](/pt-br/sdks/go/deploys) (Go)


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