--- search: tags: - vacations - POST seo: description: >- Declines a pending vacation request or cancels an approved vacation. Reference for the POST /vacations/{id}/decline endpoint in the Leadtime Public API API. sidebar: badge: POST label: Decline or cancel a vacation request title: Decline or cancel a vacation request type: openapi-operation --- Declines a pending vacation request or cancels an approved vacation. **What this does:** - For pending requests: Changes status from "Pending" to "Rejected" - For approved vacations: Changes status from "Approved" to "Cancelled" - Records who declined/cancelled the request and when (statusChangedBy, statusChangedAt) - Optionally records a reason for the decline/cancellation - Sends a notification to the employee who requested the vacation **How it works:** - The vacation ID is provided as a URL parameter - The optional reason can be provided in the request body - Only managers with "manageAll" or "manageTeams" permission can decline/cancel requests - Managers with "manageTeams" can only decline/cancel requests from employees in their teams - Returns 404 if the vacation request is not found - After decline/cancellation, the vacation will appear in the vacation history **Request body:** - `reason` (optional): Text explanation for why the vacation was declined or cancelled - Example: "Insufficient coverage during this period" - This reason will be visible in the vacation history **Use cases:** - Rejecting vacation requests that conflict with business needs - Cancelling previously approved vacations due to changed circumstances - Providing feedback to employees about why their request was not approved