---
title: "List deployments"
method: GET
path: "/servers/{namespace}/deployments"
tags: ["servers"]
---

# List deployments

`GET /servers/{namespace}/deployments`

List all deployments for a server, ordered by most recent first. Does not include deployment logs — fetch a specific deployment to see logs.

## Path parameters

- `namespace` string, required

## Response `200`

List of deployments

- object[]
  - `id` string, uuid, required
  - `status` string, required — Current deployment status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN, AUTH_REQUIRED, CANCELLED, or INTERNAL_ERROR.
  - `type` string, required — Deployment type: hosted_shttp (Smithery-hosted), external_shttp (external URL), or stdio (local binary).
  - `commit` string, nullable — Git commit SHA that triggered this deployment. Present for repo and source-tracked deployments.
  - `commitMessage` string, nullable — Git commit message associated with this deployment.
  - `branch` string, nullable — Git branch this deployment was built from.
  - `upstreamUrl` string, nullable — Upstream MCP server URL. Present only for external deployments.
  - `mcpUrl` string, uri — The MCP endpoint URL for connecting to this server.
  - `createdAt` string, required — ISO 8601 timestamp of when the deployment was created.
  - `updatedAt` string, required — ISO 8601 timestamp of the last status change.

## Other responses

- `403` — Forbidden
- `404` — Server not found

## Changes

- **2026-01-31** `5903efad445d` — 5 info
  - added the optional property `items/branch` to the response with the `200` status
  - added the optional property `items/commit` to the response with the `200` status
  - added the optional property `items/commitMessage` to the response with the `200` status
  - added the optional property `items/upstreamUrl` to the response with the `200` status
  - …1 more
- **2026-01-27** `12e546828dc5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/servers/:namespace/deployments/get.md)

---

[API](https://skmtc.dev/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/revisions/eab7f6413d3a?raw)