Skip to navigation

Start Slack OAuth

Create a signed Slack OAuth installation URL for a brain. Redirect the user to authorizationUrl; Slack sends them back to your redirect URL with a code and state to pass to confirmOauth. The signed state expires at expiresAt.

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.

Response

This endpoint returns an object.
authorizationUrlstring
Open this URL to authorize the LivingBrain Slack app
expiresAtdatetime
Expiry of the signed OAuth state

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error