v3

latestOpenAPI 3.1.02026-08-08298342605.3 KB

Capability Sources

Replace who can use an External MCP Connection

Admin-only. Full-replace semantics: send the complete desired access set (orgWide, or memberIds + teamIds). Team and member ids come from GET /v1/org.

put/v1/mcp-connections/{connectionId}/access

Path parameters

connectionIdstring typeid required

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

Request body

Response

Access 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

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[]