---
title: "Get current Git deploy configuration"
method: GET
path: "/v2/apps/{appId}/deployments/current"
tags: ["Deployments"]
---

# Get current Git deploy configuration

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

Returns the GitHub App repository linkage and the deploy webhook URL configured for the application. The response is cached for 5 minutes per (owner, application).

Requires the workspace Manager or Administrator role (or ownership) when called against a workspace-shared application.

## Path parameters

- `appId` string, required

## Response `200`

Current Git deploy configuration. Either `app` (GitHub App), `webhook`, or both may be present.

- object
  - `status` 'success', required
  - `response` object, required
    - `app` object — GitHub App repository linkage. When present, normally has all three fields populated. To detect a missing linkage, check whether `app` is omitted from the response.
      - `id` integer, nullable, required — GitHub repository numeric ID.
      - `name` string, nullable, required — Full repository name (e.g. `octocat/hello-world`).
      - `branch` string, nullable, required — Tracked branch.
    - `webhook` string, uri

## Other responses

- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `403` — The workspace member does not have the required permission for this endpoint.
- `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)
