ms:rtc:saas:adhocMeetings
- JSON
Represents the dashboard for viewing and scheduling adhoc meetings.
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
The adhocMeetings resource exposes the meetings and settings available to the user, including the ability to create a new ms:rtc:saas:adhocMeeting.
Properties
None
Links
This resource can have the following relationships.
| Link | Description |
|---|---|
| self | The link to the current resource. |
Operations
Returns a representation of the dashboard for viewing and scheduling adhoc meetings.
Request body
None
Response body
The response from a GET request contains the properties and links shown in the Properties and Links sections at the top of this page.
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 | InvalidExchangeServerVersion | |
| 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.
Creates a new ms:rtc:saas:adhocMeeting.
Request body
Click here to see the input values.
| Name | Description | Required? |
|---|---|---|
| accessLevel |
The policy that indicates which users are permitted to join the online
meeting without being placed in the online meeting lobby.
Set this property to control access to the online meeting. An application should query the organizer's eligible access levels before setting this property. | No |
| attendees | A list of the participants who have the attendee role. | No |
| automaticLeaderAssignment |
The policy that indicates which participants should be automatically promoted to leader when they join the online meeting.
Leader assignments are applied when users join the online meeting. Such users are automatically promoted to the leader role. An application should query the automatic leader assignment options to see which are available to the organizer before setting this property. The request will fail if the application attempts to schedule an online meeting using a value that is not permitted. | No |
| context | Gets or sets the Context. | No |
| description | The long description of the online meeting. | No |
| expirationTime |
The absolute date and time after which the online meeting can be deleted.
The day and time must fall between one year before and ten years after the current date and time on the server. If no value is supplied, the expiry time is set to 8 hours. | No |
| key |
Gets or sets the key.
This is an optional paramter. When an application specifies this input in the adhoc meeting creation request, the following is the behavior 1) UCAP will return the same adhocMeetingUri no matter how many times the request is called for the same key - Note: - If the other properties of the input are different and only the key is the same - the other properties will be ignored - The application should do a PUT on the adhocMeeting resource to modify the other properties 2) UCAP will NOT return the following tokens if this is specified in the meeting creation request - joinAdhocMeeting token - applications token The maximum length is 32 characters. | No |
| leaders |
A list of the participants who have the leader role.
Organizers do not need to be added to the leaders list because they are automatically added to this list. | No |
| meetingType |
The meeting type - Short or Long.
Setting this property to Long will honor ExpirationTime in the request while creating a meeting. It will default to Short and will create a meeting with ExpirationTime of 8 hours. | No |
| subject | The subject of the online meeting. | Yes |
Response body
| Item | Description |
|---|---|
| ms:rtc:saas:adhocMeeting | Represents a scheduled meeting on the user's calendar. |
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.