---
title: "List deployments for platform gateway"
method: GET
path: "/deployments"
tags: ["Gateway Internal APIs"]
---

# List deployments for platform gateway

`GET /deployments`

Returns the list of deployments (API revisions) for the authenticated platform gateway.
Used by the API Platform gateway at startup for deployment sync. Requires api-key header.
Optional query 'since' (ISO8601) returns only deployments updated after that time.

## Query parameters

- `since` string

## Response `200`

List of deployments for this gateway.

- GatewayDeploymentsResponse — Response for GET /deployments (platform contract).
  - `deployments` GatewayDeploymentInfo[]
    - `deploymentId` string — Deployment/revision identifier (revision UUID on-prem).
    - `artifactId` string — Artifact identifier (API UUID on-prem).
    - `kind` string — Artifact type (e.g. RestApi).
    - `state` string — Desired deployment state of the artifact on the gateway. Every entry returned by this endpoint is currently deployed; absence from the list means undeployed/orphaned.
    - `deployedAt` string — When the deployment was last (un)deployed (ISO-8601 date-time string).

## Other responses

- `401` — Missing or invalid api-key.
- `default` — Unexpected error

## Changes

- **2026-06-17** `11df1861b9f1` — 1 warning, 3 info
  - removed the optional property `deployments/items/updatedAt` from the response with the `200` status
  - added the optional property `deployments/items/deployedAt` to the response with the `200` status
  - added the optional property `deployments/items/state` to the response with the `200` status
  - removed the `RestAPI` enum value from the `deployments/items/kind` response property for the response status `200`
- **2026-03-13** `e536480cb9f9` — 1 info
  - endpoint added
- **2024-01-29** `f2e9e07fd354` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/wso2/apis/internal-utility-api/changes/deployments/get.md)

---

[API](https://skmtc.dev/wso2/apis/internal-utility-api.md) · [All operations](https://skmtc.dev/wso2/apis/internal-utility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wso2/internal-utility-api/revisions/0be9aa8493bc/schema)