ms:rtc:saas:decline
- JSON
Declines an incoming invitation.
Web link
For more on web links, see Web Links.
| Name | Description |
|---|---|
| rel | The resource that this link points to. In JSON, this is the outer container. |
| href | The location of this resource on the server, and the target of an HTTP operation. |
Resource description
This resource is used to decline an incoming ms:rtc:saas:messagingInvitation, phoneAudioInvitation or ms:rtc:saas:onlineMeetingInvitation as part of a new or existing ms:rtc:saas:conversation. decline causes the corresponding invitation to fail with an indication that it was declined. For an incoming ms:rtc:saas:messagingInvitation, decline will make the instant messaging modality disconnected in the corresponding conversation. For an incoming phoneAudioInvitation, decline will make the phone audio modality disconnected in the corresponding conversation. For an incoming ms:rtc:saas:onlineMeetingInvitation, decline will terminate the conversation. Other participants may remain active in the ms:rtc:saas:onlineMeeting.
Properties
None
Links
None
Operations
Declines an incoming invitation.
Request body
Click here to see the input values.
| Name | Description | Required? |
|---|---|---|
| reason | Whether the invitation is declined on behalf of the local application or on behalf the user across all of her applications. | No |
Response body
None
Synchronous errors
The errors below (if any) are specific to this resource. Generic errors that can apply to any resource are covered in Generic synchronous errors.
| Error | Code | Subcode | Description |
|---|---|---|---|
| ServiceFailure | 500 | CallbackChannelError | |
| Conflict | 409 | AlreadyExists | |
| Conflict | 409 | TooManyGroups | |
| Conflict | 409 | None | |
| Gone | 410 | CannotRedirect |
Examples
Request
JSON Response
This sample is given only as an illustration of response syntax. The semantic content is not guaranteed to correspond to a valid scenario.