API v1
v1
View as Markdown

Mark every notification as read

PUT /api/v1/notifications/read

Record that you have read everything waiting for you.

Everything unread that belongs to you is marked at once. Nothing belonging to anybody else is touched, and nothing already read has its moment changed.

Returns

How many notifications this marked. Nothing waiting answers with zero rather than an error.

data object

What this marked.

data.marked integer

How many notifications went from unread to read. Zero when there was nothing waiting.

Rate limit

Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.

PUT
curl https://my.monicahq.com/api/v1/notifications/read \
-X PUT \
-H "Authorization: Bearer $MONICA_TOKEN"
const response = await fetch('https://my.monicahq.com/api/v1/notifications/read', {
method: 'PUT',
headers: { Authorization: `Bearer ${token}` },
})
const data = await response.json()
$response = Http::withToken($token)->put('https://my.monicahq.com/api/v1/notifications/read');
Response 200
{
"data": {
"marked": 2
}
}

Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.