POST /articles/read
Mark articles read or unread. Accepts up to 100 ids so a triage pass is one call. Note read state is shared across the whole workspace, so this affects every member.
Held in this tab only (sessionStorage) and sent to the base URL above. Closing the tab clears it.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
article_ids | array | yes | Article ids from search_articles, e.g. [“art_abc123”]. |
state | boolean | yes |
Responses
Section titled “Responses”| Status | Meaning |
|---|---|
200 | Mark read |
400 | Invalid or missing parameters. |
401 | Missing or invalid API key. |
403 | The key lacks the “articles:write” scope. |
429 | Rate limit exceeded. See Retry-After. |
Requires the articles:write scope.