AlmondTill/G3N API

On this page

markNotificationRead

mutation · in the family Your own session

What it does

Mark one of your notices as read.

Mark one of YOUR notices read. An absent row refuses NOT_FOUND/NOTIFICATION; an already-read notice returns unchanged (FIRST read wins). Requires authentication.

What happens

The first read sets the time; reading again changes nothing.

Who may call it

Capability area: Your own session — What every signed-in person may do for themselves — their session, their profile and their own work.

Arguments

NameTypeRequiredNotes
notificationIdID ID!yesNo further notes.

Returns

NotificationRef NotificationRef! — One platform notice to YOUR account. Month-bucketed at the occasion's own instant; the occasion facts are immutable; readAt stamps first-read-wins.

Example request

mutation ExampleMarkNotificationRead($notificationId: ID!) {
  markNotificationRead(notificationId: $notificationId) {
    id
    kind
    severity
    occasionAt
    tokenAccountId
    fraudAlertId
    searchJobId
    exportJobId
    trainingCertificateId
    trainingRequirementId
    changeTag
    fillDraftId
    createdAt
    readAt
  }
}

Variables:

{
  "notificationId": "01900000-0000-7000-8000-321e6cfb0000"
}

Send it with the envelope naming the version: "extensions": {"at": {"version": {"name":"genesis","number":0}}}.

Example response

{
  "data": {
    "markNotificationRead": {
      "id": "01900000-0000-7000-8000-37386ae00000",
      "kind": "burn_breach",
      "severity": "blocking",
      "occasionAt": "2027-01-31T00:00:00.000Z",
      "tokenAccountId": "01900000-0000-7000-8000-fe33c4e80000",
      "fraudAlertId": "01900000-0000-7000-8000-223d82c00000",
      "searchJobId": "01900000-0000-7000-8000-72c20bfd0000",
      "exportJobId": "01900000-0000-7000-8000-7f349a170000",
      "trainingCertificateId": "01900000-0000-7000-8000-8ec2818b0000",
      "trainingRequirementId": "01900000-0000-7000-8000-8c4e9c9f0000",
      "changeTag": "<change tag>",
      "fillDraftId": "01900000-0000-7000-8000-9058a5560000",
      "createdAt": "2027-01-31T00:00:00.000Z",
      "readAt": "2027-01-31T00:00:00.000Z"
    }
  },
  "extensions": {
    "at": {
      "callId": "01EXAMPLE-CALL-ID",
      "version": {
        "requested": {
          "name": "genesis",
          "number": 0
        },
        "serviced": {
          "name": "genesis",
          "number": 0
        }
      }
    }
  }
}

Errors this call can answer