Skip to main content
GET
List personal notifications
Read access: a read-enabled personal or team REST API key, or a signed-in user. OAuth clients use the corresponding MCP tool through /mcp. Read every unread assignment and mention notification and notifications read in the last 24 hours. Use nextCursor for all pages; unreadCount is independent of page size. Unread notifications remain visible; read notifications are retained in the list for 24 hours. unreadCount is independent of page size. These are personal notifications; team API keys cannot access them. MCP clients can use list_notifications for this operation. Request conventions · API keys · MCP connections

Authorizations

Authorization
string
header
required

Personal or team Mill REST API key

Query Parameters

unread
boolean

boolean

limit
integer

integer

Required range: 1 <= x <= 100
cursor
string

string

Maximum string length: 2048

Response

Successful response. Examples are illustrative; field values vary by record.

Illustrative response shape. Fields can be absent in alternate successful flows; see the operation description and example.

items
object[]
hasMore
boolean
nextCursor
string | null
unreadCount
integer