OAuth2
OAuth Authorization Server Metadata
/.well-known/oauth-authorization-server
RFC 8414 OAuth 2.0 Authorization Server Metadata.
Responses
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
One of: 500
One of: "Unauthorized"
Try it
curl -X GET "https://connect.cambrionix.com/api/v1/.well-known/oauth-authorization-server" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"
Authorize OAuth Client (Redirect To Consent)
/oauth2/authorize
OAuth 2.1 authorization endpoint (authorization_code + PKCE), step 1: validates the request and redirects the browser to apps/web's /oauth/consent page for login + consent.
Responses
No content
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
One of: 500
One of: "Unauthorized"
Try it
curl -X GET "https://connect.cambrionix.com/api/v1/oauth2/authorize" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"
Authorize OAuth Client (Approve Consent)
/oauth2/authorize
OAuth 2.1 authorization endpoint, step 2: called by apps/web's /oauth/consent page once the user picks an org and approves. Requires an org-scoped Connect bearer token; mints the single-use authorization code for that org and returns the client's final redirect URL.
Requires a bearer access token for this API. See Authentication.
Request body
Responses
Metadata for paginated responses. This includes total count, limit, and continuation token.
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
One of: 500
One of: "Unauthorized"
Try it
curl -X POST "https://connect.cambrionix.com/api/v1/oauth2/authorize" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "client_id": "string", "code_challenge": "string", "code_challenge_method": "string", "granted_permissions": "string", "redirect_uri": "https://example.com", "scope": "string", "state": "string" }'
Get OAuth Client
/oauth2/clients/{clientId}
Public lookup of an OAuth client's display name and registered redirect URIs, used by the consent UI.
Parameters
Path parameter
Responses
Metadata for paginated responses. This includes total count, limit, and continuation token.
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
One of: 500
One of: "Unauthorized"
Try it
curl -X GET "https://connect.cambrionix.com/api/v1/oauth2/clients/{clientId}" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"
List My MCP Connections
/oauth2/grants
Lists the MCP clients the caller has connected to their current organization (one entry per client, active grants only). MCP-minted tokens are refused.
Requires a bearer access token for this API. See Authentication.
Responses
Metadata for paginated responses. This includes total count, limit, and continuation token.
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
One of: 500
One of: "Unauthorized"
Try it
curl -X GET "https://connect.cambrionix.com/api/v1/oauth2/grants" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"
Disconnect My MCP Connection
/oauth2/grants/{clientId}
Disconnects an MCP client from the caller's current organization by revoking the caller's refresh tokens for it. Access tokens already issued expire within an hour. MCP-minted tokens are refused.
Requires a bearer access token for this API. See Authentication.
Parameters
Path parameter
Responses
Metadata for paginated responses. This includes total count, limit, and continuation token.
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
One of: 500
One of: "Unauthorized"
Try it
curl -X DELETE "https://connect.cambrionix.com/api/v1/oauth2/grants/{clientId}" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"
Register OAuth Client
/oauth2/register
Registers a public OAuth client without a client secret. Access requires user consent and is limited by the user’s permissions.
Request body
Responses
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
One of: 500
One of: "Unauthorized"
Try it
curl -X POST "https://connect.cambrionix.com/api/v1/oauth2/register" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "client_name": "string", "redirect_uris": [ "https://example.com" ], "token_endpoint_auth_method": "string" }'
Revoke OAuth Token
/oauth2/revoke
RFC 7009 token revocation. Always returns 200, whether or not the token existed.
Request body
Responses
No content
Unauthorized
One of: 401
One of: "Unauthorized"
Forbidden: the token is valid but does not allow this request
Error
One of: 500
One of: "Unauthorized"
Try it
curl -X POST "https://connect.cambrionix.com/api/v1/oauth2/revoke" \ -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "client_id": "string", "token": "string", "token_type_hint": "string" }'