Start Slack OAuth

POST

/org/:org_id/project/:project_id/slack/authorize

POST

/api/v1/org/:org_id/project/:project_id/slack/authorize

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/slack/authorize \
>      -H "Authorization: Bearer <token>"

1 {
2   "authorize_url": "https://slack.com/oauth/v2/authorize?client_id=2650413579776.8329461075203&scope=app_mentions%3Aread%2Cchannels%3Ahistory%2Cchannels%3Aread%2Cchat%3Awrite%2Cchat%3Awrite.public%2Ccommands%2Cgroups%3Ahistory%2Cgroups%3Aread%2Cim%3Ahistory%2Cim%3Aread%2Cim%3Awrite%2Cusers%3Aread&redirect_uri=https%3A%2F%2Fapp.rightbrain.ai%2Fapi%2Fv1%2Fpublic%2Fslack%2Foauth%2Fcallback&state=eyJvcmdfaWQiOiIwMTkwYTIzNC01Njc4LTlhYmMtZGVmMC0xMjM0NTY3ODlhYmMiLCJwcm9qZWN0X2lkIjoiMDE5MGEyMzQtOTg3Ni01NDMyLTEwYWItY2RlZjAxMjM0NTY3IiwidHMiOjE3MDU0MTIwMDUsInVzZXJfaWQiOiIwMTkwYzIzNC0xMTExLTIyMjItMzMzMy00NDQ0NDQ0NDQ0NDQifQ.e6d2a272e812bf8be005486dce6e88eaf0d404c628ba87116dc89cf4baa53c6e"
3 }

Generate a Slack OAuth authorize URL for connecting a workspace to this project.

Send the user to authorize_url. It carries the app’s client id, the scopes the Slack app requests, the platform’s callback URL and a signed, time-limited state that pins the flow to this organization, project and user. The state expires ten minutes after it is issued. Answers 503 when Slack OAuth is not configured on this deployment.

Generate a Slack OAuth authorize URL for connecting a workspace to this project. Send the user to `authorize_url`. It carries the app's client id, the scopes the Slack app requests, the platform's callback URL and a signed, time-limited `state` that pins the flow to this organization, project and user. The state expires ten minutes after it is issued. Answers 503 when Slack OAuth 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.

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

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

Response

Slack OAuth authorize URL generated

authorize_urlstringformat: "uri">=1 character

Slack OAuth URL for connecting a workspace.

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error