PUT Update Notification Status

Endpoint

PUT /notify

Description

Updates the status of an account notification (access = 1). User and customer sessions are supported.

This endpoint is intentionally narrow:

• the client can update only status
• open_time is set automatically when the status actually changes
• the client cannot modify message payload, token, level, type, access, or timestamps directly

For a user session, the notification's stored account login must match the authenticated login. For a customer session, the account identified by the notification must be linked to that customer. The server uses the stored account login; no login or customer_id field is required in the request. Notifications for another customer's account and manager notifications are denied, even if their numeric owner ID matches the session ID.

Include the session JWT in the Authorization header. Send the request body as application/json.

Request Parameters

Name	Type	Required	Description
id	int	Yes	Notification ID
status	int	Yes	New notification status

Allowed Status Values

Value	Constant	Meaning
0	NOTIFY_LEVEL_WAITING	Waiting
1	NOTIFY_LEVEL_SENT	Sent
2	NOTIFY_LEVEL_READ	Read
3	NOTIFY_LEVEL_FAILED	Failed
4	NOTIFY_LEVEL_DELIVERED	Delivered
5	NOTIFY_LEVEL_DELETED	Deleted

Request Example

{
  "id": 101,
  "status": 2
}

Errors

HTTP	Error	Description
400	INVALID_DATA	Required fields are missing or invalid, or status is outside 0–5.
403	ACCESS_DENIED	The notification does not belong to the user account or to an account linked to the customer, or it is not an account notification.
404	INVALID_UPDATE_NOTIFY	The notification was not found or has expired.
500	INVALID_UPDATE_NOTIFY	Notification lookup or status persistence failed.

Error responses contain error (string identifier) and message (string description). Ownership failure example:

{
  "error": "ACCESS_DENIED",
  "message": "Notify does not belong to current session"
}

Response Example (200)

Success returns an empty JSON object. No notification fields are included.

{}