Skip to main content
GET
Search CoworkerMsOfficeCalendars
A CoworkerMsOfficeCalendar record represents a Microsoft Office 365 Calendar account connected to a customer’s Nexudus account. These records are created automatically when a customer connects their Office 365 Calendar from the Members Portal or the Nexudus app. Once connected, customers can book resources at a location directly from their Office 365 Calendar. Each record stores the Microsoft Graph push-notification subscription details (SubscriptionId, SubscriptionExpireDate) used to keep the calendar in sync. For more information, see the Office 365 Calendar (Customer) help article.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CoworkerMsOfficeCalendar-List role.

Query Parameters

Pagination & Sorting

integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g. Name, CreatedOn).
integer
Sort direction. 0 for ascending, 1 for descending.

Filters

integer
Filter by iD of the Nexudus resource (room or desk) used as the Microsoft Graph push-notification watch target for this connection.
integer
Filter by iD of the customer who connected their Office 365 Calendar.
string
Filter by full name of the customer who connected their Office 365 Calendar.
string
Filter by display name of the connected Office 365 Calendar.
string
Filter by microsoft Graph push-notification subscription ID used to receive calendar change notifications.
string
Filter by microsoft Graph calendar ID of the customer’s connected Office 365 calendar.
string
Filter by date and time when the Microsoft Graph push-notification subscription expires and must be renewed.

Range Filters

string
Filter by date and time when the Microsoft Graph push-notification subscription expires and must be renewed greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date and time when the Microsoft Graph push-notification subscription expires and must be renewed less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

CoworkerMsOfficeCalendar[]
The list of CoworkerMsOfficeCalendar records matching the query. See the Get one CoworkerMsOfficeCalendar endpoint for the full list of properties returned for each record.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (0 = ascending, 1 = descending).
integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response