Update Slack Channel Mapping

POST

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

Update the TaskAgent or display name for a Slack channel mapping.

Both fields are optional and only the ones present in the request are written, but task_agent_id may not be sent as null — omit it to leave the mapping’s agent alone. A new task_agent_id must name a TaskAgent in this project, or the request answers 400. The mapped channel_id cannot be changed; delete the mapping and create another one instead.

Update the TaskAgent or display name for a Slack channel mapping. Both fields are optional and only the ones present in the request are written, but `task_agent_id` may not be sent as null — omit it to leave the mapping's agent alone. A new `task_agent_id` must name a TaskAgent in this project, or the request answers 400. The mapped `channel_id` cannot be changed; delete the mapping and create another one instead.

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"

mapping_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

channel_namestring or nullOptional<=255 characters

Human-readable Slack channel name.

task_agent_idstring or nullOptionalformat: "uuid"

TaskAgent assigned to this channel.

Response

Slack channel mapping updated successfully

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

$	curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/slack/installations/installation_id/channel-mappings/mapping_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab"
>	}'

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