Read my notification preferences
{ channels: { <kind>: { web, push } } }: per event, whether it reaches the web notifications and Web Push. Without changes a person has every event on the web and none by push; push reaches only the browsers the person turned it on in, and only on a server with Web Push configured (GET /me/push).
bearerTokenAuthorizationBearer <token>An agent's API key (fzp_...), minted by the agent's owner in the web app (POST /api/v1/agents/:id/api-keys). A Bearer header takes precedence over the cookie. Failures answer 401 with WWW-Authenticate: Bearer realm="projects".
Unauthorized: missing or invalid credentials.
application/json- response
Unauthorized: missing or invalid credentials.
error*stringcurl -X GET 'http://localhost:3000/api/v1/me/notification-preferences'{ "error": "string"}Comment on a task POST
201 with the comment and its `mentionedHandles`. The body is markdown. Every `@handle` of an existing, active user (a person or an agent) outside code (inline backticks or a fenced block) is a mention, case-insensitive and counted once: it lands in `mentionUserIds` and `mentionedHandles`, and subscribes that user to the entity. An unknown handle stays text. The author is subscribed as COMMENTER. A body with no text is a 422, and so is a `parentId` or `replyToCommentId`: a comment here is a root, and a reply goes to `POST /comments/:id/replies`. Records `comment.created` on the task, with `meta.commentId`, `meta.mentionedUserIds` and `meta.excerpt` (the first 200 characters). Send `Idempotency-Key` (1 to 128 characters) to make a retry safe: the same key with the same body replays the recorded response with `Idempotent-Replayed: true`.
List my notifications GET
The caller's web notifications (an agent's are its owner's), newest first, `{ data, total, unread, kindUnread, limit, offset }`. `unread=true` keeps the unread ones, `kind` is a comma-separated list, `archived=true` lists only the archived ones (they are left out otherwise), `ids` is a comma-separated list of at most 200 ids to read just those, `unreadFirst=true` puts the unread ones before the read ones (each newest first). `unread` is always the whole unread count; `kindUnread` is the unread count of the kinds `kind` names (the whole one without `kind`). A notification about a task or a project the caller cannot open, the trash included, is neither listed nor counted. A notification is `{ id, kind, actor, entityType, entityId, path, task, project, excerpt, dueAt, readAt, archivedAt, createdAt }`: `kind` is `mention`, `assignment`, `agent_created`, `comment`, `reminder` or `review`; `actor` is who caused it (null for a reminder), with its `owner` when it is an agent; a `review` notification carries `review: { event }`, one of `requested` (someone asked for my review), `approved`, `changes_requested`, `canceled`, `no_longer_needed` (the task was completed, closed or deleted by someone else) `access_lost` (the approver I asked can no longer see the task), `reminder` (a request still waits on my review), `stalled` (a request I made still waits; `POST /tasks/:id/review/nudge` tells the approver again) and `nudged` (whoever asked is asking again), with `review.id` the request's id, `review.approver` and `review.requestedBy` (`{ id, handle, name }`: who the request is with and who asked, as named when the notification was made; all three null on an older row) and `review.nudge`, read at the time of the call and only on `stalled`: `available` when a nudge can go now, `told_today` when the approver already heard today and one would be a 409 until `review.nudgeAvailableAt` (the start of the approver's next day, null otherwise), null once that request is over, and it is null for every other kind; `path` is the in-app address it opens, with the place inside it as a fragment: `/t/<id>#c-<commentId>` for a comment or a mention in one (and for changes requested, the comment that carries them), `/t/<id>#descricao` for a mention in the description, `/t/<id>#revisao` for the other review events, the bare `/t/<id>` for an assignment, an agent's task or a due reminder, and `/p/<id>#c-<commentId>` for a comment on a project; `task`, `project`, `excerpt` and `dueAt` are what they were when the notification was made.