The :key is the id of a pending approval returned in the pending_approvals array of POST /timeoff/requests or GET /timeoff/requests.

Token behaviour

User token — identifies a specific user. member_id is not required (the user represented by the token is the actor). approver_id is optional; when omitted it defaults to the member represented by the token. Users may only act on their own approval step (i.e. approver_id, if supplied, must correspond to the user represented by the token), unless they have the time off approval override permission. In that case, they may provide any approver_id corresponding to a valid approver for the approval.

Account token — both member_id and approver_id are required. member_id identifies the member performing the action (retrieved from GET /members) and must belong to the account. approver_id identifies the approver whose pending step is being acted upon. When the actor and the approver are the same member, include both fields in the request body with that member's id.

Response

Returns the updated time off request, including the remaining pending_approvals after this action was processed.

{
  "id": "4d3",
  "employee_id": "4d3",
  "from_date": "2026-03-03T00:00:00.000",
  "to_date": "2026-03-03T00:00:00.000",
  "formatted_period": "03 March 2026",
  "state": "pending",
  "requesting_total": 1,
  "timeoff_tracking_unit": "full_days",
  "half_days": [],
  "updated_by": "Foo Bar",
  "category_name": "Sick Leave",
  "pending_approvals": [
    {
      "id": "4d4",
      "approver_id": "1839d70f-7caa-4f02-9e3f-c46cced76f5b"
    }
  ]
}

employee_id is the SPI key of the employee the request belongs to.

pending_approvals will be empty when no further approvals are required (e.g. after the final approval or after a rejection).

Error responses