List Slack Channel Mappings

GET

/org/:org_id/project/:project_id/slack/installations/:installation_id/channel-mappings

List Slack channel mappings for an installation.

Channels with no mapping are handled by the installation’s default_task_agent_id, so an empty list does not mean the workspace is inert.

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

installation_idstringRequiredformat: "uuid"

Response

Successfully retrieved Slack channel mappings

idstringformat: "uuid"

Slack channel mapping ID.

slack_installation_idstringformat: "uuid"

Parent Slack installation ID.

channel_idstring

Slack channel ID.

task_agent_idstringformat: "uuid"

TaskAgent assigned to this channel.

createdstring

When the channel mapping was created.

modifiedstring

When the channel mapping was last updated.

channel_namestring or nullOptional

Human-readable Slack channel name.

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error

1	[
2	{
3	"id": "019a5f0c-4c82-7d25-9f69-5d2e8b3c7f41",
4	"slack_installation_id": "019a5f0c-3b71-7d24-9e58-4c1d7a2b6e30",
5	"channel_id": "C024BE91L",
6	"task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
7	"created": "2024-01-16T14:02:18.114905Z",
8	"modified": "2024-01-16T14:02:18.114905Z",
9	"channel_name": "support-escalations"
10	}
11	]

$	curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/slack/installations/installation_id/channel-mappings \
>	-H "Authorization: Bearer <token>"