> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braintrust.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack alert permissions in project settings

> [!NOTE]
>
> **Applies to:**
>
> * Plan - Any
> * Deployment - Any
> *
> *

## Summary

[Slack alert configuration](https://docs.braintrust.dev/observe/alerts.md) has two permission levels: the organization-level **Manage settings** permission is required to establish the initial Slack workspace connection, while `Project: update` permission determines whether users can configure Slack channels for project alerts. This allows team members to manage alerts for their projects without access to sensitive organization settings.

## Permission Levels

### Organization Level: Connecting Slack

Only members of the **Owners** [permission group](https://docs.braintrust.dev/admin/access-control.md), or a custom permission group with the **Manage settings** organization permission, can establish the initial Slack workspace connection in ** Settings** > [** Integrations**](https://www.braintrust.dev/app/~/configuration/integrations). This must be done before any project-level Slack alerts can be configured.

### Project Level: Configuring Alert Channels

`Project: update` permission determines whether users can select Slack channels and configure alerts within individual projects. Once the organization Slack connection exists, users with this permission can access the Slack channel dropdown in the alert configuration dialog.

## Configuration Steps

### Step 1: Connect Slack (Organization Admin)

A user with the organization-level **Manage settings** permission connects the Slack workspace to the Braintrust organization through ** Settings** > [** Integrations**](https://www.braintrust.dev/app/~/configuration/integrations) > **Enable Slack**.

### Step 2: Grant Project Permissions

Assign `Project: update` permission to team members who need to configure alerts for specific projects.

### Step 3: Configure Alert Channels

Users with `Project: update` can now access the alert dialog and select Slack channels when creating or editing project alerts.

## Permission Benefits

This permission model allows team members to manage alerts for their projects without granting access to organization-wide settings like API configurations or billing information.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.