Profile

Update Notification Preference

Update ONE event type, named by event_type.

Singular on purpose, matching the app: a caller that sent the whole map would race with the person changing a different toggle in the browser and silently revert it.

put/profile/notification-preferences

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/profile/notification-preferences
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

event_typestring required

The event to configure, as listed by GET /profile/notification-preferences. An unknown one is refused with the valid list.

enabledboolean nullable
copilot_proactiveboolean nullable
copilot_bridgeboolean nullable
bridge_whatsappboolean nullable
bridge_slackboolean nullable
bridge_roamboolean nullable
bridge_imessageboolean nullable
bridge_emailboolean nullable
routing'conversation' | 'notify_only' | 'off' nullable
urgency'interrupt_now' | 'fold_into_brief' nullable
hot_overrideboolean nullable

Response

Successful Response

dataOrgPayload required

An open envelope for a single role, team, member or account record.

Open on purpose. The app's own response models on this surface grow with the product - RoleResponse gained rep_limits and manages_role_slugs, TeamResponse gained channel counts and a campaign count - and a pinned mirror would SILENTLY DROP whatever it had not caught up on. A dropped permission in a role read is the worst possible kind of stale: it reads as "they do not have it".

Changes

No recorded changes to this operation across all 2 revisions of this API.