Skip to navigation

Get Teams Integration Setup

Return everything a Teams tab needs to finish connecting this integration: the deep link that installs the Rightbrain Teams app, the integration’s authorization state, and the Teams installations already linked to it.

auth_state is connected once an installation is linked and reauth_required otherwise, in which case auth_state_reason is teams_installation_required. Both are null until the integration has a default auth principal at all.

Answers 422 when integration_id names an integration that is not of type teams, and 503 when the Teams app id is not configured on this deployment.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

OR
AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

integration_idstringRequiredformat: "uuid"
org_idstringRequiredformat: "uuid"
The unique identifier of the organization.
project_idstringRequiredformat: "uuid"
The unique identifier of the project.

Response

Teams integration setup details retrieved successfully
teams_install_urlstring
auth_statestring or nullOptional
auth_state_reasonstring or nullOptional
linked_installationslist of objectsOptional

Errors

400
Bad Request Error
403
Forbidden Error
422
Unprocessable Entity Error