Routes
Users
Capacity
Exceptions

Update Capacity Exception

This request updates an existing capacity exception and returns the updated resource.

capacityMinutes means the user's available capacity per day for each day in the exception date/range. It is not the total duration of the exception range.

Examples:

  • capacityMinutes: 0 => unavailable that day (or each day in the range).
  • capacityMinutes: 480 => 8 hours available per day.

Return data description

PropertyDescription
exceptionIDUnique ID for the capacity exception record.
userIDThe user the exception applies to.
createdByUserIDThe user who created the exception.
exceptionStartDateThe first date the exception applies (YYYY-MM-DD).
exceptionEndDateThe last date the exception applies (YYYY-MM-DD). Null when the exception is only for one day.
capacityMinutesAllowed capacity in minutes per day for the exception date/range.
hoursPerDayDerived whole-hour portion of capacityMinutes.
minutesPerDayDerived minute remainder after hoursPerDay.
exceptionTitleOptional short title for the exception.
exceptionNotesOptional notes/details for the exception.
exceptionTypeStructured planned/unplanned classification (planned, unplanned, or null when unset).
patch/v2/users/capacity/exceptions/{userID}/{exceptionID}

Request

Request body

exceptionStartDatestring date
exceptionEndDatestring date
capacityMinutesinteger
exceptionTitlestring
exceptionNotesstring
exceptionTypeunknown

Response

Update Capacity Exception

exceptionIDinteger
userIDinteger
createdByUserIDinteger
exceptionStartDatestring date
exceptionEndDatestring date
capacityMinutesinteger
hoursPerDayinteger
minutesPerDayinteger
exceptionTitlestring
exceptionNotesstring
exceptionTypeunknown

Changes

No recorded changes to this operation across all 4 revisions of this API.