Skip to navigation
Slack

Update a Slack binding

Update which notifications a bound Slack channel receives — daily briefs, new connections, and page changes. Omitted fields are left unchanged.

Authentication

x-api-keystring

Your Living Brain API key. Create one from the dashboard; keys are scoped to an organization and carry the role of the member they were issued to.

Path parameters

brainIdstringRequired
Brain id
bindingIdstringRequired
Slack channel binding id

Headers

x-subject-idstringRequired
Identifies the end user the request is made on behalf of. Brains are owned by a subject, so this determines which brains the caller can see.

Request

This endpoint expects an object.
notifyBriefsbooleanOptional
Receive daily summary of brain updates
notifyConnectionsbooleanOptional
Get notified when strong new connections are discovered
notifyChangesbooleanOptional
Get notified when pages are updated with new knowledge

Response

This endpoint returns an object.
idstring
Unique identifier for the channel binding.
brainIdstring
ID of the brain this channel is bound to.
installationIdstring
ID of the Slack installation the channel belongs to.
teamIdstring

Slack workspace (team) ID.

channelIdstring
Slack channel ID.
channelNamestring or null
Slack channel name, when available.
statusenum
Whether the binding is currently delivering notifications.
Allowed values:
notifyBriefsboolean
Whether the channel receives the daily brief.
notifyConnectionsboolean
Whether the channel is notified when strong new connections are discovered.
notifyChangesboolean
Whether the channel is notified when pages are updated with new knowledge.
createdAtdatetime
ISO 8601 timestamp of when this record was created.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error