---
title: "Fetch and mark pending notifications delivered"
method: POST
path: "/api/me/notifications/deliver"
---

# Fetch and mark pending notifications delivered

`POST /api/me/notifications/deliver`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/me/notifications/deliver`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Returns the member's new events for up to ten conversations; each event is returned once across sessions. Every MCP tool does this automatically. POST because fetching advances delivery state; this does not mark conversation messages read or confirm human receipt.

## Response `200`

Newly delivered notifications.

- object
  - `notifications` object[], required
    - `id` string, required
    - `type` 'resource.saved' | 'resource.ready' | 'resource.failed' | 'resource.removed' | 'resource.linked' | 'resource.unlinked' | 'invitation.sent' | 'task_creation.ready' | 'task_creation.context_received' | 'task_creation.failed' | 'task_creation.published' | 'application.received' | 'application.withdrawn' | 'application.accepted' | 'application.declined' | 'task.closed' | 'task.expired' | 'task.poster_visibility_changed' | 'work.turn_in_requested' | 'work.submitted' | 'work.changes_requested' | 'work.approved' | 'work.completed' | 'rating.received' | 'cancellation.requested' | 'work.cancelled' | 'payment.transfer_succeeded' | 'payment.transfer_failed' | 'payment.refund_requested' | 'payment.refund_updated' | 'payment.refund_failed' | 'payment.dispute_opened' | 'payment.dispute_closed' | 'payment.transfer_reversed' | 'message.received' | 'comment.received' | 'comment.replied' | 'file_access.granted' | 'file_access.revoked' | 'files.shared' | 'files.not_copied' | 'preferred_worker.added' | 'safety.report_resolved' | 'safety.content_removed' | 'safety.content_restored', required
    - `applicationId` string, nullable, required
    - `taskId` string, required
    - `taskTitle` string, required
    - `summary` string, required
    - `createdAt` string, date-time, required
    - `url` string, required

## Other responses

- `401`: Sign in first.

---

[API](https://skmtc.dev/toma/apis/toma-api.md) - [All operations](https://skmtc.dev/toma/apis/toma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toma/apis/toma-api/revisions/b4e56e1db5a2?raw)