Update Slack Installation

POST

/org/:org_id/project/:project_id/slack/installations/:installation_id

Update Slack installation defaults or lifecycle status.

Both fields are optional and only the ones present in the request are written. default_task_agent_id must name a TaskAgent in this project, or the request answers 400. Setting status to anything other than active also marks the linked integration’s credential revoked and puts it into reauth_required, so reconnecting the workspace means running the OAuth flow again.

Update Slack installation defaults or lifecycle status. Both fields are optional and only the ones present in the request are written. `default_task_agent_id` must name a TaskAgent in this project, or the request answers 400. Setting `status` to anything other than `active` also marks the linked integration's credential revoked and puts it into `reauth_required`, so reconnecting the workspace means running the OAuth flow again.

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"

Request

This endpoint expects an object.

statusenum or nullOptional

Lifecycle status for the Slack installation.

default_task_agent_idstring or nullOptionalformat: "uuid"

Default TaskAgent used when a channel has no explicit mapping.

Response

Slack installation updated 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

$	curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/slack/installations/installation_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"status": "revoked"
>	}'

1	{
2	"id": "019a5f0c-3b71-7d24-9e58-4c1d7a2b6e30",
3	"project_id": "0190a234-9876-5432-10ab-cdef01234567",
4	"team_id": "T024BE7LD",
5	"bot_user_id": "U0KRQLJ9H",
6	"installed_by_user_id": "0190c234-1111-2222-3333-444444444444",
7	"status": "revoked",
8	"created": "2024-01-16T13:33:25.247662Z",
9	"modified": "2024-02-04T09:12:41.882014Z",
10	"team_name": "Meridian Freight",
11	"default_task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab"
12	}