Notifications

Mark activity read by ids, all, a category, or a subject

Send exactly one selector: ids, all, category, chat_id, link, or subject_type with subject_id. By subject marks every row about that subject read, wherever it was counted -- opening a post, job or grant clears everything said about it. By chat marks every row that links into that chat (mentions, group adds, missed calls), the selector a chat screen uses. By link marks every row whose in-app link is that address (or that address with a query string), e.g. /acting/<id>: the selector for a screen whose rows have other subjects (an approval's subject is the exercise, the screen the mandate). A row that is read counts as seen too. 422 no_selector when none is sent.

post/api/v1/activity/read

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/activity/read
  • Auth: API key in header api-key

Request body

idsstring[]
allboolean
categorystring

Every row in this category (chats, posts, money, jobs, access, agents, devices, plugins, account). Anything else is a 422.

subject_typestring

A model name such as Message, Chat, Posting. Send with subject_id.

subject_idstring
chat_idstring uuid

Every row that links into this chat. Not a UUID is a 422.

linkstring

An in-app address such as /acting/<id>: every row whose link is that address, or that address with a query string. Must start with / and be at most 512 characters, else a 422.

Response

OK.

unread_countinteger
markedinteger

Changes

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