BIbigchange
Absences

Update an absence

Changed on

Update the details or status of a single absence (required scope resources:write)

patch/v1/absences/{absenceId}

Request

  • Base URL
    https://api.bigchange.com
  • URL
    https://api.bigchange.com/v1/absences/{absenceId}
  • Auth
    HTTP bearer

Path parameters

absenceIdinteger required

Absence id

Headers

Customer-Idinteger required

The customer identifier

Request body

status'requested' | 'queried' | 'rejected' | 'approved'

The status of a resource absence<p>Possible values:</p><ul><li><b>requested</b>: The absence has been requested by the resource</li><li><b>queried</b>: The absence has been queried and requires review</li><li><b>rejected</b>: The absence has been rejected</li><li><b>approved</b>: The absence has been approved</li></ul>

commentstring

Comment or reason for the status change<br/><br/>Max length: 500 characters<br/><br/>Optional: Omit to retain current value

absenceTypeIdinteger

The unique identifier of the absence type. Must reference a valid absence type for this customer<br/><br/>Optional: Omit to retain current value

startAtstring date-time

The updated start date and time of the absence<br/><br/>Optional: Omit to retain current value

endAtstring date-time

The updated end date and time of the absence<br/><br/>Optional: Omit to retain current value

Example request

{
  "status": "requested",
  "comment": "Approved by manager",
  "absenceTypeId": 1,
  "startAt": "2026-01-01T00:00:00.0000000+00:00",
  "endAt": "2026-01-02T00:00:00.0000000+00:00"
}

Response

No Content

Changes