saveCalendarEntry

Updates the specified calendar exclusion if it already exists, or create it if it does not exist. (Note that in this context, "entries" is synonymous with "exclusions.")

  • A recurring exclusion is defined using the recurrence rule expression, not as a series of individual dates and times. You cannot edit an individual occurrence of a recurring exclusion as a separate entity, so any amendments made to a recurring exclusion will be applied to all occurrences of that exclusion.
  • If the request is to update an existing calendar exclusion, the version value returned in the earlier request to retrieve the calendar exclusion (getCalEntries) should be passed in this saveCalendarEntry request. If the given version value does not match the current value held in the database, a conflicting update must have occurred since the initial request to retrieve the exclusion, and the save request will be rejected. The caller must then perform another getCalEntries request.
  • If the version value shows no conflict, the calendar exclusion will be updated, and the response will include a new version value.
  • Amendments to existing calendar exclusions will not be reflected in those deadline calculations that have already been performed.
  • Times for exclusions are saved as UTC.
Required System Action
writeCalendars
API Descriptions