Mark a notice from manitu read or unread
Sets a notice of this access to read, or back to new.
Marks a notice manitu left for the calling access as read, or as unread again, by its notice_id; the customer panel stops or starts showing it as new. Answers the notice as manitu_access_notice_getPOST /v1/access/notice/get returns it.
Counts against: writes (60 per hour per account)
manitu_access_notice_set on https://mcp.manitu.de/mcpAnnotations as tools/list sends them
Description for the model
Marks a notice manitu left for the access this connection uses as read, or as unread again, by its notice_id. Mark it read only when the user has seen what it says - then the customer panel stops showing it as new. Returns the notice as manitu_access_notice_getPOST /v1/access/notice/get shows it.
Arguments
notice_id (required)integer | stringThe notice_id of the notice. Never guess one.
status (required)stringread: the user has seen it; new: show it as unread again.
approval_tokenstringwrite-onlyThe token of the way call_again from the approval_required answer of the same call - only after the user said yes to everything in its elements. Valid 15 minutes, once.
Result structuredContent, checked against the schema
notice_idintegerstatusstringnew: not read yet; read: marked as read (opened in the panel, or set); deleted is never listed.
prioritystringurgent: the user should read it soon - it is about something that needs doing.
subjectstring | nullcreated_atstring | nullread_atstring | nullWhen it was first read; it stays when set back to new.
bodystring | nullThe text, written by manitu.
Authentication
One of X-API-Key, Authorization: Bearer … - never more than one in a request. More
Request body JSON; unknown fields are refused
notice_id (required)integer | stringThe notice_id of the notice.
status (required)stringread: the user has seen it; new: show it as unread again.
approval_tokenstringwrite-onlyThe token of the way call_again from the approval_required answer of the same call - only after the user said yes to everything in its elements. Valid 15 minutes, once.
Response in data; the rest of the body as on every call
notice_idintegerstatusstringnew: not read yet; read: marked as read (opened in the panel, or set); deleted is never listed.
prioritystringurgent: the user should read it soon - it is about something that needs doing.
subjectstring | nullcreated_atstring | nullread_atstring | nullWhen it was first read; it stays when set back to new.
bodystring | nullThe text, written by manitu.
Statuses
200Success.400The input is wrong, or the request itself (INVALID_INPUT). Each entry names its field and its reason - correct the input and call again.401No credential was presented, or it was not recognised (UNAUTHENTICATED).403The credential is valid, but may not do this (PERMISSION_DENIED). The reason says why - another credential is the way, not a repeat.429Too many calls. The Retry-After header says when to try again.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.