Slack alert permissions in project settings

​

Summary

Slack alert configuration 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, or a custom permission group with the Manage settings organization permission, can establish the initial Slack workspace connection in Settings > 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 > 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.