POST
/api/public/v1/notifications/{notificationId}/handle

Mark notification as handled

Mark a notification as handled by the calling employee.

Required scope

The access token must carry this scope. A token missing it gets 403 Forbidden. Grant them to an API client under Dev Tools → API, to an assistant or CLI sign-in when you approve or edit it under Dev Tools, and to a teammate under Employee → Permissions.

notifications:write

Path Parameters

NameTypeRequiredDescription
notificationIdstringRequiredNotification ID.
POSTExample request
curl
curl -X POST "https://www.pxb.app/api/public/v1/notifications/{notificationId}/handle" \
  -H "Authorization: Bearer your_access_token"
200Example response
json
{
  "message": "Notification marked as handled successfully!",
  "content": {
    "notification": {
      "id": "ntf_1",
      "handledAt": "2026-06-01T00:00:00Z"
    }
  }
}

In the console

The same thing done by hand, for anyone comparing the API against the screen they already use.

Sidebar → notifications
/dashboard
  1. Open the notifications panel from the sidebar.
  2. Act on a notification to mark it handled.