v3

latestOpenAPI 3.1.02026-08-08298342605.3 KB

Authentication

Edit an External MCP Connection

Workspace owners and super-admins can edit any connection. Other org members can edit only connections they created. Name and direct access changes preserve credentials. URL, authentication type, or credential-mode changes invalidate the old identity atomically. Secret fields are write-only optional replacements and are never returned. expectedUpdatedAt prevents stale edits.

put/v1/mcp-connections/{connectionId}

Path parameters

connectionIdstring typeid required

Den TypeID with 'emc_' prefix and a 26-character base32 suffix.

Request body

expectedUpdatedAtstring date-time required

namestring required

urlstring uri required

authType'oauth' | 'apikey' | 'none' required

credentialMode'shared' | 'per_member' required

apiKeystring

authorizationServerIssuerstring uri nullable

requestedScopesstring[]

Response

Connection updated.

idstring required

namestring required

urlstring required

authType'oauth' | 'apikey' | 'none' required

credentialMode'shared' | 'per_member' required

connectedboolean required

connectedAtstring nullable required

createdByNamestring nullable

updatedAtstring date-time required

connectedForMeboolean required

needsReconnectboolean

credentialHealth'unknown' | 'ready' | 'reconnect_required'

credentialHealthReason'authorization_rejected' | 'credential_expired' | 'post_authorization_validation_failed' nullable

credentialHealthCheckedAtstring date-time nullable

issuerReviewRequiredboolean

reconnectActionOwner'member' | 'organization_admin' nullable

missingFeaturesstring[]

externalAccountIdstring nullable

grantedScopesstring[]

tenantIdstring nullable

requiredAuthType'oauth' | 'apikey' | 'none' nullable

authPolicyConfirmedboolean

authTypeMismatchboolean

oauthClientConfiguredboolean

oauthClientRequiredboolean

setupRequiredboolean

oauthClientIdstring nullable

oauthCallbackUrlstring nullable

oauthSharedCallbackUrlstring nullable

oauthClientMetadataUrlstring nullable

oauthCallbackMode'shared-v1' | 'isolated-v1' | 'legacy-v1' nullable

oauthRegistrationSource'pre-registered' | 'client-metadata' | 'dynamic' nullable

authorizationServerIssuerstring nullable

requestedScopesstring[]

identityChangedboolean required

reconnectionRequiredboolean required