Mark entries as read
Marks up to 50 entries as read for you, so the What's new pop-up of the Control Panel no longer opens with them; sending the same request again changes nothing. Every id must be an entry you may read: if one is not, nothing is marked and the answer is 404.
POST/ api/ whats-new/ seen
Body
announcement_idsarray of integersRequired
The ids of the entries to mark as read. A repeated id counts once. Up to 50 items.
Returns
200 The entries are read now.
Fields of the 200 answer
dataobjectRequired
Fields
seenarray of integersRequired
The ids now read, newest first.
unseenintegerRequired
How many entries you have still not read.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
404 | none | Check the id. You see only what your account can reach. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/whats-new/seen \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"announcement_ids": [
4120,
4090
]
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/whats-new/seen', [
'announcement_ids' => [
4120,
4090,
],
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/whats-new/seen', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
announcement_ids: [
4120,
4090,
],
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.post(
"https://manage.corefinity.com/api/whats-new/seen",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"announcement_ids": [
4120,
4090,
],
},
)
data = res.json() if res.content else None{
"data": {
"seen": [
4120,
4090
],
"unseen": 3
}
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"message": "Not found."
}{
"code": "invalid",
"errors": {
"announcement_ids": [
"The announcement ids field is required."
]
},
"field": "announcement_ids",
"message": "The announcement ids field is required.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it
Was this helpful?