---
title: "List recent notifications for the signed-in person"
method: GET
path: "/api/v1/account/notifications"
tags: ["Account"]
---

# List recent notifications for the signed-in person

`GET /api/v1/account/notifications`

## Request

- Base URL: `https://api.dotsy.ai`
- URL: `https://api.dotsy.ai/api/v1/account/notifications`
- Auth: HTTP bearer

Merges up to thirty items from up to ten workspace feeds, newest first. `workspace` filters to one membership (ignored when not a member). `needsYou` keeps only items that need review.

## Query parameters

- `workspace` string
- `needsYou` string

## Headers

- `X-Dotsy-Workspace` string

## Response `200`

Merged notification items.

- NotificationsList
  - `items` NotificationItem[], required
    - `id` string, uuid, required
    - `seq` integer, required
    - `kind` 'form.entry' | 'agent.changes' | 'publish.warnings' | 'publish.stopped' | 'domain.status' | 'experiment.outcome', required
    - `siteSlug` string, required
    - `siteTitle` string, nullable, required
    - `count` integer, required
    - `needsYou` boolean, required
    - `updatedAt` integer, required: Unix ms.
    - `unread` boolean, required
    - `workspaceId` string, required
    - `workspaceName` string, required
    - `data` object, required

## Other responses

- `403`: `session_required`: sign in as a person.

---

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