---
title: "Update Resource Unavailabilities"
method: PUT
path: "/v1/resources/resource/{resource_id}/unavailability/{id}"
tags: ["API / Resource", "Use case / Master data sync"]
---

# Update Resource Unavailabilities

`PUT /v1/resources/resource/{resource_id}/unavailability/{id}`

Update an existing unavailability for a resource.

## Path parameters

- `resource_id` string, uuid, required
- `id` string, uuid, required

## Request body

- ResourceUnavailabilityInput
  - `external_id` string, nullable — External identifier of the unavailability
  - `start_time` string, date-time, required — Start time of the unavailability
  - `end_time` string, date-time, nullable — End time of the unavailability, leave empty for open interval
  - `reason` 'DRIVER_FUNERAL' | 'DRIVER_HOLIDAY' | 'DRIVER_JOB_APPLICATION_LEAVE' | 'DRIVER_LATE_START_EARLY_LEAVE' | 'DRIVER_MEDICAL_EXAM' | 'DRIVER_OFF_SHIFT_PATTERN' | 'DRIVER_OTHER' | 'DRIVER_PARENTAL_LEAVE' | 'DRIVER_PUBLIC_HOLIDAY' | 'DRIVER_RECUP' | 'DRIVER_REDUCED_WORKING_HOURS_SCHEME' | 'DRIVER_SHIFT_PATTERN' | 'DRIVER_SICKNESS' | 'DRIVER_SOCIAL_LEAVE' | 'DRIVER_TEMPORARY_UNEMPLOYMENT' | 'DRIVER_TRAINING' | 'DRIVER_UNAUTHORISED_ABSENCE' | 'DRIVER_UNION_LEAVE' | 'DRIVER_WORK_ACCIDENT' | 'VEHICLE_BRAKE_TEST' | 'VEHICLE_CLEANING' | 'VEHICLE_FRC_CERTIFICATE' | 'VEHICLE_HIRE' | 'VEHICLE_HYDRAULIC_INSPECTION' | 'VEHICLE_INSPECTION' | 'VEHICLE_LIFT_OPS_EQUIP_REGULATIONS' | 'VEHICLE_MAINTENANCE' | 'VEHICLE_MOT_TEST' | 'VEHICLE_OFF_ROAD' | 'VEHICLE_OTHER' | 'VEHICLE_PRESSURE_TEST' | 'VEHICLE_REPAIR' | 'VEHICLE_SERVICE' | 'VEHICLE_TACHOGRAPH_CALIBRATION' | 'SUBCONTRACTOR_HOLIDAY' | 'SUBCONTRACTOR_SICKNESS' | 'SUBCONTRACTOR_OTHER', required
  - `description` string, nullable

## Response `200`

Successful Response

- ResourceUnavailabilityOutput
  - `external_id` string, nullable — External identifier of the unavailability
  - `start_time` string, date-time, required — Start time of the unavailability
  - `end_time` string, date-time, nullable — End time of the unavailability, leave empty for open interval
  - `reason` 'DRIVER_FUNERAL' | 'DRIVER_HOLIDAY' | 'DRIVER_JOB_APPLICATION_LEAVE' | 'DRIVER_LATE_START_EARLY_LEAVE' | 'DRIVER_MEDICAL_EXAM' | 'DRIVER_OFF_SHIFT_PATTERN' | 'DRIVER_OTHER' | 'DRIVER_PARENTAL_LEAVE' | 'DRIVER_PUBLIC_HOLIDAY' | 'DRIVER_RECUP' | 'DRIVER_REDUCED_WORKING_HOURS_SCHEME' | 'DRIVER_SHIFT_PATTERN' | 'DRIVER_SICKNESS' | 'DRIVER_SOCIAL_LEAVE' | 'DRIVER_TEMPORARY_UNEMPLOYMENT' | 'DRIVER_TRAINING' | 'DRIVER_UNAUTHORISED_ABSENCE' | 'DRIVER_UNION_LEAVE' | 'DRIVER_WORK_ACCIDENT' | 'VEHICLE_BRAKE_TEST' | 'VEHICLE_CLEANING' | 'VEHICLE_FRC_CERTIFICATE' | 'VEHICLE_HIRE' | 'VEHICLE_HYDRAULIC_INSPECTION' | 'VEHICLE_INSPECTION' | 'VEHICLE_LIFT_OPS_EQUIP_REGULATIONS' | 'VEHICLE_MAINTENANCE' | 'VEHICLE_MOT_TEST' | 'VEHICLE_OFF_ROAD' | 'VEHICLE_OTHER' | 'VEHICLE_PRESSURE_TEST' | 'VEHICLE_REPAIR' | 'VEHICLE_SERVICE' | 'VEHICLE_TACHOGRAPH_CALIBRATION' | 'SUBCONTRACTOR_HOLIDAY' | 'SUBCONTRACTOR_SICKNESS' | 'SUBCONTRACTOR_OTHER', required
  - `description` string, nullable
  - `id` string, uuid, required — Unique identifier of the unavailability

## Other responses

- `400` — Bad Request — invalid input or malformed request
- `401` — Unauthorized — missing or invalid authentication credentials
- `403` — Forbidden — insufficient permissions for this operation
- `422` — Validation Error
- `429` — Too Many Requests — rate limit exceeded. See the `Retry-After` header
- `500` — Internal Server Error
- `503` — Service Unavailable — temporarily unable to handle the request

---

[API](https://skmtc.dev/qargo/apis/qargo-tms-api.md) · [All operations](https://skmtc.dev/qargo/apis/qargo-tms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qargo/qargo-tms-api/revisions/56fb7643aeba/schema)