Mark my notifications read
Mark my notifications read. Marks the CALLER's own notifications read: `ids` (1–100) or `all: true`, exactly one. Any role, write scope. markedCount is the number actually changed; ids that were already read, unknown or not the caller's, or that the caller's current role or project access no longer covers (the rows GET /notifications hides), are skipped (reported in warnings) without revealing which. `all: true` marks only the notifications the caller can currently see: hidden unread ones stay unread and come back unread when the access returns. There is no mark-unread.
Authorization
BearerAuth Personal Access Token. Mint at Settings → API. Token shape: hsk_<env>_<prefix12>_<secret32>.
In: header
Header Parameters
Caller-generated UUID/ULID; replay returns the cached response within 24h.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Exactly one of ids or all: true.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/notifications/read" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{}'{ "data": { "markedCount": 0, "unreadCount": 0 }, "warnings": [ "string" ]}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}{ "error": { "code": "unauthenticated", "message": "string", "fields": { "property1": "string", "property2": "string" }, "requiredPlan": "studio", "feature": "string", "requestId": "string" }}List my notifications
The CALLER's own in-app notifications in this workspace, newest first. Any role, read scope. Never returns another member's notifications, and lists (and counts in unreadCount) only the rows the caller's current role and project access still cover: team-payout notifications while the caller is Owner/Admin, invoice and budget notifications while Owner/Admin/Manager, and for a Member mention, assignment and comment notifications only on projects they can still access. Hidden rows are kept and return with the access; until then they cannot be marked read. Returns unreadCount. Titles and snippets may quote teammates' text (untrusted). Unknown or repeated query parameters return 422.
Hoursmith MCP server
Connect Claude, ChatGPT, Cursor, VS Code, Claude Code, Zed, and other AI assistants to your Hoursmith workspace — by signing in to the hosted server, or by running the npm package with an API token.