Forgecroft Docs
Quickstart Guides Essentials Power Agent API Reference
Core ConceptsCLI ReferenceGo SDKAuthenticationAPI KeysRoles & PermissionsCreating WorkspacesVCS ConnectionsCredentialsState BackendsExecution ModesWorkspace AttributesDependencies & PromotionStacks OverviewCreating StacksEnvironments & VarfilesPromotion GraphManaging StacksRun LifecyclePlan vs ApplyChangesetsApprovalsLogsForce UnlockDrift DetectionTroubleshootingGovernance OverviewPolicy SetsWriting RegoRego PlaygroundApproval RulesExternal ChecksGovernance PreviewGovernance TimelineManaging TeamsNotification ChannelsNotification TargetsUser PreferencesAccess GrantsAudit EventsGitHub AppSlackCredential TypesState Backends
Guides / Notifications

User Notification Preferences

Control how you personally receive notifications — email, Slack DM, both, or none.

Viewing Your Preferences

GET /me/notification-preferences

Response:

{ "channel": "email" }

Or with Slack connected:

{ "channel": "both", "slack_user_id": "U123456" }

Available Channels

ChannelDescription
emailReceive notifications via email
slack_dmReceive notifications via Slack direct message
bothReceive via both email and Slack DM
noneDo not receive personal notifications

Updating Your Preferences

PUT /me/notification-preferences
{
  "channel": "slack_dm"
}

The operation is idempotent — setting the same value is a no-op.

Slack DM Requirements

To use slack_dm or both, you must have:

  1. Connected your Slack account via the OAuth flow
  2. A matching Slack user ID stored in your preference record

Default

If no preference record exists, the default is email.