Open MCP Portaldocs
ReferenceAdmin

Change an auth provider (platform admins); the slug never changes

PATCH/v1/admin/auth-providers/{providerId}

Omit clientSecret to keep it. Changing clientId marks every connection to the provider needs_reconsent and erases their tokens (they belong to the old app). Turning the provider off refuses calls that require it and new connections at once; connections are kept. Errors as for create. Audited as auth_provider.update (clientSecretChanged, never the secret). While MCP servers in oauth mode link the provider (registration platform_provider), changing authorizationUrl or tokenUrl is 409 in_use (details as for delete); changing clientId also resets their server connections. Server-bound providers (kind mcp_server) are not reachable here (404).

Path Parameters

providerId*string
Formatuuid

Header Parameters

If-Match*string

The resource's revision, as returned in ETag (for example "3"). Missing returns 428; stale returns 412.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/admin/auth-providers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "slug": "github",    "name": "GitHub",    "kind": "oauth2",    "preset": "github",    "enabled": true,    "clientId": "string",    "hasClientSecret": true,    "clientSecretHint": "string",    "tokenAuthMethod": "client_secret_basic",    "pkce": true,    "authorizationUrl": "https://github.com/login/oauth/authorize",    "tokenUrl": "https://github.com/login/oauth/access_token",    "revocationUrl": "string",    "userinfoUrl": "string",    "defaultScopes": [      "string"    ],    "scopeParam": "string",    "scopeSeparator": " ",    "tokenResponseFormat": "standard",    "extraAuthorizeParams": {      "property1": "string",      "property2": "string"    },    "logoUrl": "string",    "redirectUri": "https://mcp.example.com/connect/callback",    "serverCount": 0,    "connectionCount": 0,    "revision": 0,    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "createdByName": "string"  }}