Notifications

Get user room subscription settings

Changed on

This endpoint returns the list of a user's room subscription settings. Corresponds to liveblocks.getUserRoomSubscriptionSettings.

get/users/{userId}/room-subscription-settings

Request

  • Base URL: https://api.liveblocks.io/v2
  • URL: https://api.liveblocks.io/v2/users/{userId}/room-subscription-settings
  • Auth: none declared

Path parameters

userIdstring required

ID of the user

Example:user-123

Query parameters

startingAfterstring

A cursor used for pagination. Get the value from the nextCursor response of the previous page.

Example:eyJjcmVhdGVkQXQiOjE2NjAwMDA5ODgxMzd9
limitinteger

A limit on the number of elements to be returned. The limit can range between 1 and 50, and defaults to 50.

Example:20
organizationIdstring

The organization ID to filter room subscription settings for.

Example:org_123456789

Response

Success. Returns the list of the user's room subscription settings.

nextCursorstring nullable required

A cursor to use for pagination. Pass this value as startingAfter to get the next page of results. null if there are no more results.

Example response

{
  "nextCursor": null,
  "data": [
    {
      "threads": "all",
      "textMentions": "mine",
      "roomId": "my-room-id"
    }
  ]
}

Changes

    • breaking

      for the query request parameter limit, the type changed from number to integer

    • breaking

      the // response's property type changed from no type to string for status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id get-users-userId-subscription-settings removed and replaced with get-user-room-subscription-settings

    • info

      added the new optional query request parameter organizationId

    • info

      the response property became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      added the required property to the response with the status

    • info

      endpoint added