Cambrionix connect
Developers
Authentication API

OAuth2

OAuth Authorization Server Metadata

GET

/.well-known/oauth-authorization-server

RFC 8414 OAuth 2.0 Authorization Server Metadata.

Responses

200
object
authorization_endpointstringrequired
code_challenge_methods_supportedstring[]required
grant_types_supportedstring[]required
issuerstringrequired
jwks_uristring
registration_endpointstringrequired
response_types_supportedstring[]required
revocation_endpointstringrequired
scopes_supportedstring[]required
token_endpointstringrequired
401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired

One of: 500

messagestringrequired

One of: "Unauthorized"

detailstringrequired

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)

GET

/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

200

No content

401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired

One of: 500

messagestringrequired

One of: "Unauthorized"

detailstringrequired

Try it

curl -X GET "https://connect.cambrionix.com/api/v1/oauth2/authorize" \
  -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"

Authorize OAuth Client (Approve Consent)

POST

/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

object
client_idstringrequired
code_challengestring
code_challenge_methodstring
granted_permissionsstring
redirect_uristring (uri)required
scopestring
statestring

Responses

200
object
_metadataobject

Metadata for paginated responses. This includes total count, limit, and continuation token.

resultobjectrequired
401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired

One of: 500

messagestringrequired

One of: "Unauthorized"

detailstringrequired

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

GET

/oauth2/clients/{clientId}

Public lookup of an OAuth client's display name and registered redirect URIs, used by the consent UI.

Parameters

clientIdstringpathrequired

Path parameter

Responses

200
object
_metadataobject

Metadata for paginated responses. This includes total count, limit, and continuation token.

resultobjectrequired
401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired

One of: 500

messagestringrequired

One of: "Unauthorized"

detailstringrequired

Try it

curl -X GET "https://connect.cambrionix.com/api/v1/oauth2/clients/{clientId}" \
  -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"

List My MCP Connections

GET

/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

200
object
_metadataobject

Metadata for paginated responses. This includes total count, limit, and continuation token.

resultobject[]required
401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired

One of: 500

messagestringrequired

One of: "Unauthorized"

detailstringrequired

Try it

curl -X GET "https://connect.cambrionix.com/api/v1/oauth2/grants" \
  -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"

Disconnect My MCP Connection

DELETE

/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

clientIdstringpathrequired

Path parameter

Responses

200
object
_metadataobject

Metadata for paginated responses. This includes total count, limit, and continuation token.

resultobjectrequired
401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired

One of: 500

messagestringrequired

One of: "Unauthorized"

detailstringrequired

Try it

curl -X DELETE "https://connect.cambrionix.com/api/v1/oauth2/grants/{clientId}" \
  -H "Authorization: Bearer $CONNECT_ACCESS_TOKEN"

Register OAuth Client

POST

/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

object
client_namestringrequired
redirect_urisstring[]required
token_endpoint_auth_methodstring

Responses

200
object
client_idstringrequired
client_namestringrequired
redirect_urisstring[]required
401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired

One of: 500

messagestringrequired

One of: "Unauthorized"

detailstringrequired

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

POST

/oauth2/revoke

RFC 7009 token revocation. Always returns 200, whether or not the token existed.

Request body

object
client_idstringrequired
tokenstringrequired
token_type_hintstring

Responses

200

No content

401

Unauthorized

object
codeintegerrequired

One of: 401

messagestringrequired

One of: "Unauthorized"

detailstringrequired
403

Forbidden: the token is valid but does not allow this request

object
codeintegerrequired
messagestringrequired
detailstringrequired
default

Error

object
codeintegerrequired

One of: 500

messagestringrequired

One of: "Unauthorized"

detailstringrequired

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"
}'