Notifications

List notifications

The token owner's own notifications for this workspace (the bell of the app: the workspace's notices and the user's personal ones scoped to it or to no workspace), newest first. Expired notifications are left out. Role permission: none (any member).

get/notifications

Request

  • Base URL: https://joinways.app/api/v1
  • URL: https://joinways.app/api/v1/notifications
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://joinways.app/oauth/authorize, token URL https://joinways.app/api/oauth/token, scopes: mcp.read)

Query parameters

pageinteger

1-based page number.

per_pageinteger

Items per page.

unread_onlyboolean

true: only notifications neither read (dismissed) nor done (status: done).

categorystring
created_fromstring date-time

Lower bound on created_at (inclusive, ISO 8601).

created_tostring date-time

Upper bound on created_at (inclusive, ISO 8601).

Response

Page of notifications.

Example response

{
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1234,
    "total_pages": 25
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.