Skip to navigation
Slack

Confirm Slack OAuth

Complete a Slack installation by exchanging the code and state Slack returned to your redirect URL. Returns the new installation ID.

Authentication

x-api-keystring

Your Living Brain API key. Create one from the dashboard; keys are scoped to an organization and carry the role of the member they were issued to.

Path parameters

brainIdstringRequired
Brain id

Headers

x-subject-idstringRequired
Identifies the end user the request is made on behalf of. Brains are owned by a subject, so this determines which brains the caller can see.

Request

This endpoint expects an object.
codestringRequired
Slack authorization code
statestringRequired
Signed OAuth state

Response

This endpoint returns an object.
installationIdstring
ID of the Slack installation that was created or updated.
brainIdstring
ID of the brain the installation is attached to.
teamIdstringOptional

Slack workspace (team) ID.

teamNamestringOptional
Slack workspace name.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error