notify

Mark a recipient inbox in bulk

Changed on

Mark a page of notifications seen or read. Page size is fixed server-side; keep calling with the returned cursor until it is null. The cursor resumes after the last notification this call marked, and a cursor issued for the other state is a 400 INVALID_CURSOR. A notification past its send's history horizon is skipped. Archiving in bulk is deliberately not offered.

post/products/notify/inbox/state

Request

Request body

recipient_idstring required

The inbox owner. Read in the form a send keys its recipient by (trimmed, with an email address lowercased the way Identity stores it), so the id or address as the send named it reads the same inbox. A value that is blank once trimmed, longer than 256 UTF-8 bytes, or holding a control character or noncharacter names no inbox and is rejected 400.

state'seen' | 'read' required
cursorstring

Continuation token from the previous call.

Response

The page was marked.

Changes

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status