List notification preferences for a user

GET

/users/{userId}/notification-preferences

Users

Returns one entry per supported notification topic for the target user, with platform defaults applied. Read is authorized via Cedar's read action — every role with ReadActions (admin, manager, member, viewer) can read another user's preferences in the same workspace; writes (PATCH/DELETE) are restricted to users.manage.

Request

Path Params

Header Params

Responses

🟢200OK

application/json

Notification preferences retrieved successfully

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.aworld.cloud/dashboard/v1/users//notification-preferences' \
--header 'x-external-user-id;' \
--header 'x-user-id;'

Response Example

{
    "items": [
        {
            "topic": "LEARNING_UPDATES",
            "subscribed": true,
            "isDefault": true,
            "updatedAt": "2019-08-24T14:15:22.123Z"
        }
    ]
}

Modified at 2026-06-15 16:41:21

Search users

Get user by external ID