API ReferenceConnectionsSlack

Get Slack Installation

Get the Slack installation details for a project workspace binding. Answers 404 when the installation belongs to a different project, so an id from another project is indistinguishable from one that does not exist. The workspace's bot token is never returned.

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

org_idstringRequiredformat: "uuid"
The organization ID
project_idstringRequiredformat: "uuid"
The project ID
installation_idstringRequiredformat: "uuid"

Response

Slack installation details retrieved successfully
idstringformat: "uuid"
Slack installation ID.
project_idstringformat: "uuid"
Project that owns the Slack installation.
team_idstring
Slack workspace team ID.
bot_user_idstring
Slack bot user ID for the installed app.
installed_by_user_idstringformat: "uuid"
User who completed the Slack installation flow.
statusenum
Lifecycle status for the Slack installation.
createdstring
When the installation was created.
modifiedstring
When the installation was last updated.
team_namestring or nullOptional

Human-readable Slack workspace name.

default_task_agent_idstring or nullOptionalformat: "uuid"
Default TaskAgent used when a channel has no explicit mapping.

Errors

400
Bad Request Error
403
Forbidden Error
422
Unprocessable Entity Error