Calendars
Get all absence events
get /api/http/calendars/absence-events
Get/search absences. Parameters are applied as ' AND ' filters.
|
Request arguments |
|---|
dateFrom: string (format: full-date) (Query) ( Required )
| dateTo: string (format: full-date) (Query) ( Required )
| team: string (Query) ( Nullable and Optional , defaults to null)
| location: string (Query) ( Nullable and Optional , defaults to null)
| role: string (Query) ( Nullable and Optional , defaults to null)
|
|
Get all birthday events
get /api/http/calendars/birthday-events
Get/search birthdays. Parameters are applied as ' AND ' filters.
|
Request arguments |
|---|
dateFrom: string (format: full-date) (Query) ( Required )
| dateTo: string (format: full-date) (Query) ( Required )
| team: string (Query) ( Nullable and Optional , defaults to null)
| location: string (Query) ( Nullable and Optional , defaults to null)
| role: string (Query) ( Nullable and Optional , defaults to null)
|
|
Get all starred birthday events
get /api/http/calendars/birthday-events/starred
Get/search birthdays in a specific time period for starred profiles.
|
Request arguments |
|---|
dateFrom: string (format: full-date) (Query) ( Required )
| dateTo: string (format: full-date) (Query) ( Required )
|
|
Update event participation
patch /api/http/calendars/event-participations/{id}
Update RSVP / calendar event participation status for a calendar event attached to an article
|
Request arguments |
|---|
id: string (Path) ( Required )
| object with fields: |
|
Get all events
get /api/http/calendars/events
Get calendar events attached to an article in a specific time period
|
Request arguments |
|---|
dateFrom: string (format: full-date) (Query) ( Required )
| dateTo: string (format: full-date) (Query) ( Required )
|
|
Get event
get /api/http/calendars/events/{id}
Get a calendar event attached to an article
|
Request arguments |
|---|
id: string (Path) ( Required )
|
|
Get all holidays
get /api/http/calendars/holidays
Get/search holidays. Parameters are applied as ' AND ' filters.
|
Request arguments |
|---|
startDate: string (format: full-date) (Query) ( Required )
| endDate: string (format: full-date) (Query) ( Required )
| team: string (Query) ( Nullable and Optional , defaults to null)
| location: string (Query) ( Nullable and Optional , defaults to null)
| role: string (Query) ( Nullable and Optional , defaults to null)
| workingDays: boolean (Query) ( Nullable and Optional , defaults to null)
|
|
Create meeting
post /api/http/calendars/meetings
Create a meeting
Required permissions: Update meetings
|
Request arguments |
|---|
object with fields: summary: string ( Required )
description: string ( Nullable and Optional , defaults to null)
occurrenceRule: CalendarEventSpec ( Required )
locations: array of string ( Optional , defaults to [])
profiles: array of string ( Optional , defaults to [])
externalParticipants: array of string ( Optional , defaults to [])
teams: array of string ( Optional , defaults to [])
visibility: MeetingVisibility ( Optional , defaults to "EVERYONE")
modificationPreference: MeetingModificationPreference ( Optional , defaults to "PARTICIPANTS")
joiningPreference: MeetingJoiningPreference ( Optional , defaults to "NOBODY")
notifyOnExport: boolean ( Optional , defaults to true)
organizer: string ( Nullable and Optional , defaults to null)
conferenceData: EventConferenceData ( Nullable and Optional )
attachments: array of MeetingAttachment ( Nullable and Optional , defaults to null)
calendarId: CalendarIdentifier ( Nullable and Optional , defaults to null)
|
|
Get all meetings
get /api/http/calendars/meetings
Search meetings by name, location, time period and other parameters. Parameters are applied as ' AND ' filters while values in lists of locations, profiles and teams have ' OR ' semantics.
Required permissions: View meetings
|
Request arguments |
|---|
$skip: string (Query) ( Nullable and Optional , defaults to null)
| $top: integer (format: int32) (Query) ( Nullable and Optional , defaults to 100)
| summaryQuery: string (Query) ( Optional , defaults to "")
| locationsQuery: array of string (Query) ( Optional , defaults to [])
| startingAfter: string (format: date-time) (Query) ( Nullable and Optional , defaults to null)
| endingAfter: string (format: date-time) (Query) ( Nullable and Optional , defaults to null)
| endingBefore: string (format: date-time) (Query) ( Nullable and Optional , defaults to null)
| startingBefore: string (format: date-time) (Query) ( Nullable and Optional , defaults to null)
| profiles: array of string (Query) ( Optional , defaults to [])
| teams: array of string (Query) ( Optional , defaults to [])
| organizer: string (Query) ( Nullable and Optional , defaults to null)
| includePrivate: boolean (Query) ( Optional , defaults to false)
| includeArchived: boolean (Query) ( Optional , defaults to false)
| includeMeetingInstances: boolean (Query) ( Optional , defaults to true)
|
Response |
|---|
object with fields: next: string ( Required )
totalCount: integer (format: int32) ( Nullable and Optional , defaults to null)
data: array of DTO_Meeting ( Required )
|
|
Get next meeting occurrence
get /api/http/calendars/meetings/next-occurrence
Search for the next meeting occurrence that starts after the provided time point or after the current time if it is not specified
Required permissions: View meetings
|
Request arguments |
|---|
meetingId: string (Query) ( Required )
| since: string (format: date-time) (Query) ( Nullable and Optional , defaults to null)
|
|
Get meeting occurrences for period
get /api/http/calendars/meetings/occurrences
Search for occurrences of a meeting that start in the provided time interval. Interval limits are inclusive, response is limited by the first 1_000 results by default.
Required permissions: View meetings
|
Request arguments |
|---|
meetingId: string (Query) ( Required )
| since: string (format: date-time) (Query) ( Required )
| until: string (format: date-time) (Query) ( Required )
| limit: integer (format: int32) (Query) ( Nullable and Optional , defaults to null)
|
|
Get meeting occurrences for period for multiple meetings
get /api/http/calendars/meetings/occurrences-by-meeting
Search for occurrences of a meeting that start in the provided time interval. Interval limits are inclusive, response is limited by the first 1_000 results by default ( per meeting ) .
Required permissions: View meetings
|
Request arguments |
|---|
meetingIds: array of string (Query) ( Required )
| since: string (format: date-time) (Query) ( Required )
| until: string (format: date-time) (Query) ( Required )
| limit: integer (format: int32) (Query) ( Nullable and Optional , defaults to null)
|
|
Get meeting participation statuses for profiles
get /api/http/calendars/meetings/participation-statuses
Required permissions: View meetings
|
Request arguments |
|---|
id: string (Query) ( Required )
| profileIds: array of string (Query) ( Required )
|
|
Get rsvp statuses for external users
get /api/http/calendars/meetings/participation-statuses-external
Required permissions: View meetings
|
Request arguments |
|---|
id: string (Query) ( Required )
| emails: array of string (Query) ( Required )
|
|
Get profile participation statuses for meetings
get /api/http/calendars/meetings/profile-participation
Required permissions: View meetings
|
Request arguments |
|---|
profileId: string (Query) ( Required )
| events: array of string (Query) ( Required )
|
Response |
|---|
array of object with fields: |
|
Get profile participation status records for meetings
get /api/http/calendars/meetings/profile-participation-records
Required permissions: View meetings
|
Request arguments |
|---|
profileId: string (Query) ( Required )
| events: array of string (Query) ( Required )
|
|
Get meeting
get /api/http/calendars/meetings/{id}
Required permissions: View meetings
|
Request arguments |
|---|
id: string (Path) ( Required )
|
|
Update meeting
patch /api/http/calendars/meetings/{id}
Patch a meeting. Only not-null parameters and not empty diffs will be applied.
Required permissions: Update meetings
|
Request arguments |
|---|
id: string (Path) ( Required )
| object with fields: summary: string ( Nullable and Optional , defaults to null)
description: string ( Nullable and Optional , defaults to null)
occurrenceRule: CalendarEventSpec ( Nullable and Optional , defaults to null)
locationsDiff: Diff ( Optional )
profilesDiff: Diff ( Optional )
externalParticipantsDiff: Diff ( Optional )
teamsDiff: Diff ( Optional )
visibility: MeetingVisibility ( Nullable and Optional , defaults to null)
modificationPreference: MeetingModificationPreference ( Nullable and Optional , defaults to null)
joiningPreference: MeetingJoiningPreference ( Nullable and Optional , defaults to null)
notifyOnExport: boolean ( Optional , defaults to true)
organizer: string ( Nullable and Optional , defaults to null)
targetDate: string (format: date-time) ( Nullable and Optional , defaults to null)
modificationKind: RecurrentModification ( Optional , defaults to "All")
conferenceData: EventConferenceData ( Nullable and Optional , defaults to null)
attachments: array of MeetingAttachment ( Nullable and Optional , defaults to null)
calendarId: CalendarIdentifier ( Nullable and Optional , defaults to null)
|
|
Delete meeting
delete /api/http/calendars/meetings/{id}
Required permissions: Update meetings
|
Request arguments |
|---|
id: string (Path) ( Required )
| targetDate: string (format: date-time) (Query) ( Nullable and Optional , defaults to null)
| modificationKind: RecurrentModification (Query) ( Optional , defaults to "All")
|
|
Add conference room
post /api/http/calendars/meetings/{id}/conference-rooms
Required permissions: Manage meeting conference rooms
|
Request arguments |
|---|
id: string (Path) ( Required )
| object with fields: |
|
Remove conference room
delete /api/http/calendars/meetings/{id}/conference-rooms
Required permissions: Manage meeting conference rooms
|
Request arguments |
|---|
id: string (Path) ( Required )
| roomId: string (Query) ( Required )
| dateTime: string (format: date-time) (Query) ( Required )
|
|
Update profile participation status
patch /api/http/calendars/meetings/{id}/participation-status
Update profile participation status for a meeting
Required permissions: Update meeting RSVP status
|
Request arguments |
|---|
id: string (Path) ( Required )
| object with fields: profileId: string ( Required )
status: EventParticipationStatus ( Required )
targetDate: string (format: date-time) ( Nullable and Optional , defaults to null)
modificationKind: RecurrentModification ( Optional , defaults to "All")
|
|
Get all membership events
get /api/http/calendars/membership-events
Get/search membership events. Parameters are applied as ' AND ' filters.
Required permissions: View memberships
|
Request arguments |
|---|
dateFrom: string (format: full-date) (Query) ( Required )
| dateTo: string (format: full-date) (Query) ( Required )
| team: string (Query) ( Nullable and Optional , defaults to null)
| location: string (Query) ( Nullable and Optional , defaults to null)
| role: string (Query) ( Nullable and Optional , defaults to null)
|
|
Get all non working days events
get /api/http/calendars/non-working-days-events
Get/search non-working day events. Parameters are applied as ' AND ' filters.
|
Request arguments |
|---|
dateFrom: string (format: full-date) (Query) ( Required )
| dateTo: string (format: full-date) (Query) ( Required )
| member: string (Query) ( Nullable and Optional , defaults to null)
| team: string (Query) ( Nullable and Optional , defaults to null)
| location: string (Query) ( Nullable and Optional , defaults to null)
| role: string (Query) ( Nullable and Optional , defaults to null)
|
|
Last modified: 06 September 2023