---
title: "Get a release"
method: GET
path: "/servers/{qualifiedName}/releases/{id}"
tags: ["servers"]
---

# Get a release

`GET /servers/{qualifiedName}/releases/{id}`

Retrieve release details including status, git metadata, pipeline logs, and MCP endpoint URL.

## Path parameters

- `qualifiedName` string, required
- `id` string, required

## Response `200`

Release info

- DeploymentInfo
  - `id` string, uuid, required
  - `status` string, required — Current status: QUEUED, WORKING, SUCCESS, FAILURE, FAILURE_SCAN, AUTH_REQUIRED, AUTH_TIMEOUT, CANCELLED, or INTERNAL_ERROR.
  - `type` string, required — Release type: hosted_shttp (Smithery-hosted), external_shttp (external URL), or stdio (local binary).
  - `commit` string, nullable — Git commit SHA that triggered this release.
  - `commitMessage` string, nullable — Git commit message associated with this release.
  - `branch` string, nullable — Git branch this release was built from.
  - `upstreamUrl` string, nullable — Upstream MCP server URL. Present only for external releases.
  - `logs` DeploymentLogEntry[] — Pipeline log entries. Only included when fetching a single release.
    - `stage` 'deploy' | 'scan' | 'metadata' | 'publish', required — Pipeline stage: deploy (bundle upload), scan (security/OAuth check), metadata (tool discovery), publish (generated artifacts).
    - `level` string, required — Log level: 'start', 'end', 'info', 'success', or 'failure'.
    - `message` string, required — Human-readable log message.
    - `timestamp` string, required — ISO 8601 timestamp of the log entry.
    - `error` DeploymentLogEntryError
      - `message` string
  - `mcpUrl` string, uri — The MCP endpoint URL for connecting to this server.
  - `createdAt` string, required — ISO 8601 timestamp of when the release was created.
  - `updatedAt` string, required — ISO 8601 timestamp of the last status change.

## Other responses

- `404` — Server or release not found

---

[API](https://skmtc.net/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.net/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smithery-ai/smithery-platform-api/revisions/60b8c3d2fecf/schema)