Skip to main content
POST
/
api
/
orgs
/
{id}
/
notifications
/
preferences
Update current member notification preferences
curl --request POST \
  --url https://atollhq.com/api/orgs/{id}/notifications/preferences \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "channel": "in_app"
}
'
{
  "preference": {
    "org_id": "<string>",
    "member_id": "<string>",
    "enabled": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

id identifier

Body

application/json
​
eventType
enum<string>
required
Available options:
mention.created,
issue.assigned,
comment.added,
issue.status_changed
​
enabled
boolean
required
​
channel
enum<string>
default:in_app
Available options:
in_app,
google_chat

Response

Successful response

​
preference
object
required

Current-member notification preference. Supported channels are in_app and google_chat; google_chat is currently supported for mention.created. Google Chat delivery is independent from in-app delivery. Disabling google_chat does not acknowledge or clear in-app notifications. Disabling in_app mention.created delivery also attempts to acknowledge current unread mention notifications.