diff options
author | Joas Schilling <213943+nickvergessen@users.noreply.github.com> | 2021-10-25 13:22:08 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-10-25 13:22:08 +0300 |
commit | 351c3090c073a7208c830447ac7807bf916d2718 (patch) | |
tree | 7a74b1948080a349968ad8adfa77908a99d76bdf /docs | |
parent | 00269d075ef38cc25d0cfca5364854264a0332b3 (diff) | |
parent | 730a18416b3db0c86ebe8daff0a90eaef651d278 (diff) |
Merge pull request #6338 from nextcloud/feature/noid/allow-to-opt-out-of-call-notifications
Allow to opt out of call notifications
Diffstat (limited to 'docs')
-rw-r--r-- | docs/capabilities.md | 1 | ||||
-rw-r--r-- | docs/constants.md | 4 | ||||
-rw-r--r-- | docs/conversation.md | 18 |
3 files changed, 23 insertions, 0 deletions
diff --git a/docs/capabilities.md b/docs/capabilities.md index e26e40889..ce9739805 100644 --- a/docs/capabilities.md +++ b/docs/capabilities.md @@ -84,3 +84,4 @@ title: Capabilities ## 13 * `direct-mention-flag` - The conversation list populates the boolean `unreadMentionDirect` when the user was mentioned directly (ignoring @all mentions) since their last visit +* `notification-calls` - Whether the API to opt out of call notifications is available diff --git a/docs/constants.md b/docs/constants.md index 90423a13e..7dea4199c 100644 --- a/docs/constants.md +++ b/docs/constants.md @@ -46,6 +46,10 @@ title: Constants * `2` Notify on mention * `3` Never notify +### Participant call notification levels +* `0` Off +* `1` On (default) + ### Participant read status privacy * `0` Read status is public * `1` Read status is private diff --git a/docs/conversation.md b/docs/conversation.md index d06ae9495..b8cb0e813 100644 --- a/docs/conversation.md +++ b/docs/conversation.md @@ -312,6 +312,24 @@ + `401 Unauthorized` When the participant is a guest + `404 Not Found` When the conversation could not be found for the participant +## Set notification level for calls + +* Required capability: `notification-calls` +* Method: `POST` +* Endpoint: `/room/{token}/notify-calls` +* Data: + + field | type | Description + ---|---|--- + `level` | int | The call notification level (See [Participant call notification levels](constants.md#Participant-call-notification-levels)) + +* Response: + - Status code: + + `200 OK` + + `400 Bad Request` When the given level is invalid + + `401 Unauthorized` When the participant is a guest + + `404 Not Found` When the conversation could not be found for the participant + ## Open a conversation * Required capability: `listable-rooms` |