---
title: "List recent deploys for an application"
method: GET
path: "/v2/apps/{appId}/deployments"
tags: ["Deployments"]
---

# List recent deploys for an application

`GET /v2/apps/{appId}/deployments`

Returns the deploy log for the application as a 2-D array: each inner array is one deploy's lifecycle (`pending` → `clone` → `commit` → `restarting` → `success`). Every event carries a derived `source` (`git` when produced by a webhook or GitHub App push, `upload` otherwise). Empty array when no deploys have been recorded.

## Path parameters

- `appId` string, required

## Response `200`

Recent deploys grouped by deploy attempt.

- object
  - `status` 'success', required
  - `response` array[], required — One inner array per deploy attempt.
    - DeployEvent[] — Lifecycle events for a single deploy, in chronological order.
      - `id` string, required — Deploy identifier. For Git deploys this is the commit SHA (40 hex); for uploads it is an opaque ID.
      - `state` 'pending' | 'clone' | 'commit' | 'restarting' | 'success' | 'failed', required — Lifecycle stage. `pending` queued, `clone` Git checkout, `commit` file diff snapshot, `restarting` container restart, `success` finished, `failed` aborted.
      - `date` string, date-time, required
      - `source` 'git' | 'upload', required — How the deploy was triggered. `git` covers both webhook and GitHub App pushes.
      - `branch` string — Present on `state: "clone"` events for Git deploys.
      - `files` object — Present on `state: "commit"` events. Lists the files changed in this deploy.
        - `added` string[], required
        - `removed` string[], required
        - `modified` string[], required

## Other responses

- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `404` — The target application could not be found, or the caller is not a member of the workspace.
- `429` — The authenticated user or API key exceeded the global request budget.
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)