Skip to main content
PUT
Set up Slack or Teams

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

provider
enum<string>
required
Available options:
slack,
teams

Body

application/json

Set up or change the Slack app or Teams bot. Empty secrets keep the stored ones.

client_id
string
required
Required string length: 1 - 256
client_secret
string | null
Maximum string length: 1024
bot_token
string | null

Slack only: the bot token (xoxb-…).

Maximum string length: 1024
Pattern: ^xoxb-[A-Za-z0-9-]+$
tenant
string | null

Teams only: the Entra directory id or domain.

Maximum string length: 256
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)+)$
catalog_app_id
string | null

Teams only: the app's id once it is in your org's catalog.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
enabled
boolean
default:true

Response

Successful Response

The platform's Slack app or Teams bot. No secret is ever returned.

provider
enum<string>
required
Available options:
slack,
teams
configured
boolean
required

Whether an admin has set it up.

enabled
boolean
required

Off hides it from everyone.

client_id
string | null
secrets_set
string[]

Which secrets are stored (never their values).

workspace
string | null

Slack: the workspace the bot token belongs to.

tenant
string | null

Teams: the Entra directory.

catalog_app_id
string | null

Teams: the app's id in your org's catalog.

connected_people
integer
default:0

How many people connected.

redirect_url
string | null

The redirect URL to register with the provider.