Notifications

Mark Notifications By Entity Read

Mark the whole team's notifications for one record as READ.

The rows survive, stamped with who read them, so the bell can still show that someone acknowledged it. Idempotent: only unread rows are touched.

Omitting notification_type is the wide option - it marks every notification anyone in the org holds for that record, including mentions that were meant for a person.

put/notifications/by-entity/read

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/notifications/by-entity/read
  • Auth: HTTP bearer

Query parameters

entity_typestring required

Record type the notification is about, e.g. chat.

entity_idstring required

Id of that record.

notification_typestring nullable

Narrow to one notification type. Pass the type you own - omitting it also marks unrelated notifications on the same record, such as a colleague's mention.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataCrmRecordPayload required

An open envelope for one record, one dashboard or one job receipt.

Open because most of these reads are COMPUTED shapes - an engagement summary, a next-best-step, an intelligence status - that grow with the product, and dropping a field from an advisory read makes it say "nothing to report" rather than "we did not tell you".

Changes

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