---
title: "Get connection"
method: GET
path: "/connect/{namespace}/{connectionId}"
tags: ["connect"]
---

# Get connection

`GET /connect/{namespace}/{connectionId}`

Get details for a specific connection. Requires service token with connections:read scope.

## Path parameters

- `namespace` string, required
- `connectionId` string, required

## Response `200`

Connection details

- Connection
  - `connectionId` string, required — Connection ID (auto-generated or developer-defined)
  - `name` string, required — Human-readable name
  - `transport` 'http' | 'uplink' — Connection transport
  - `mcpUrl` string, nullable, required — MCP server URL. Null for uplink connections.
  - `metadata` object, nullable, required
  - `mock` MockConfig
    - `enabled` boolean, required — Turn mock mode on for this connection.
    - `scenario` string — Natural-language starting-state for the simulator (threaded into the LLM system prompt so generated data is consistent with the scenario across calls).
  - `iconUrl` string, nullable
  - `createdAt` string — ISO 8601 timestamp
  - `status` union
    - object
      - `state` 'connected', required
    - object
      - `state` 'disconnected', required
    - object
      - `state` 'auth_required', required
      - `setupUrl` string, uri — Hosted Smithery URL for completing setup and OAuth
      - `authorizationUrl` string, uri — Deprecated compatibility alias for setupUrl
    - object
      - `state` 'input_required', required
      - `setupUrl` string, uri — Hosted Smithery URL for completing setup in the browser
      - `http` CredentialProfileHttp, required
        - `headers` object
        - `query` object
      - `missing` object, required
        - `headers` string[], required
        - `query` string[], required
    - object
      - `state` 'error', required
      - `message` string, required — Error message
  - `serverInfo` ServerInfo
    - `name` string, required
    - `title` string
    - `icons` object[]
      - `src` string, required
      - `mimeType` string
      - `sizes` string[]
      - `theme` 'light' | 'dark'
    - `version` string, required
    - `websiteUrl` string
    - `description` string

## Other responses

- `400` — Bad request
- `404` — Connection not found

## Changes

- **2026-04-23** `10f65f70e8c0` — 2 breaking, 1 info
  - response property `mcpUrl` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added `subschema #2: ConnectionStatusDisconnected` to the `status` response property `oneOf` list for the response status `200`
  - added the optional property `transport` to the response with the `200` status
- **2026-04-21** `e0848f588e5f` — 1 breaking, 2 info
  - the `mock` response's property type changed from `boolean` to `object` for status `200`
  - added the optional property `mock/scenario` to the response with the `200` status
  - added the required property `mock/enabled` to the response with the `200` status
- **2026-04-20** `0ac2ebb989ed` — 1 info
  - added the optional property `mock` to the response with the `200` status
- **2026-04-16** `626a29bee024` — 3 info
  - added the optional property `status/oneOf[subschema #2: ConnectionStatusAuthRequired]/setupUrl` to the response with the `200` status
  - added the optional property `status/oneOf[subschema #3: ConnectionStatusInputRequired]/setupUrl` to the response with the `200` status
  - response property `status/oneOf[subschema #2: ConnectionStatusAuthRequired]/authorizationUrl` deprecated
- **2026-04-12** `01f97a60fd96` — 1 breaking
  - added `subschema #3: ConnectionStatusInputRequired` to the `status` response property `oneOf` list for the response status `200`

[Change history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/connect/:namespace/:connectionId/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/10f65f70e8c0?raw)