Notifications

List notifications

Changed on

List the authenticated user's notifications, most recent first, optionally filtered by event type or archived status.

post/notifications.list

Request

  • Base URL
    https://app.getoutline.com/api
  • URL
    https://app.getoutline.com/api/notifications.list
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://app.getoutline.com/oauth/authorize
      Token URL: https://app.getoutline.com/oauth/token scopes: read, write

Request body

offsetnumber
limitnumber
eventTypestring

Filter to notifications of a specific event type.

archivedboolean

When true, only archived notifications are returned.

Example request

{
  "limit": 25
}

Response

OK

Example response

{
  "data": [
    {
      "actor": {
        "name": "Jane Doe"
      }
    }
  ],
  "pagination": {
    "limit": 25
  },
  "policies": [
    {
      "abilities": {
        "read": true,
        "update": true,
        "delete": false
      }
    }
  ]
}

Changes