MCP Connections

Replace MCP connection

Replace name, server_url, and secret_id with compare-and-set on row_version. Omitting secret_id makes the connection anonymous. A disabled connection stays disabled. Idempotency-Key is required.

put/v1/mcp-connections/{connection_id}

Request

  • Base URL: https://api.sandbase.ai
  • URL: https://api.sandbase.ai/v1/mcp-connections/{connection_id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

Idempotency-Keystring required

Required. 1-128 characters without leading or trailing whitespace. Reuse the same key and body when retrying.

Request body

namestring required
server_urlstring uri required

HTTPS URL without credentials, query, or fragment.

secret_idstring

Optional active Secret for the same server_url. Omit for an anonymous server.

row_versioninteger required

Response

Connection

idstring required

Connection ID (mcp_ prefix).

namestring required
server_urlstring required
secret_idstring
status'active' | 'disabled' required
row_versioninteger required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.