> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Decline a leave request

> Decline an existing leave request.

Use this endpoint when a submitted or approved leave request should be declined.

### Parameters

<ParamField path="id" type="string" initialValue="lvr_6r3wLwX44s0Ak0bDkP5n2r7Q" required>
  The ID of the leave request to decline.
</ParamField>

<ParamField body="reason" type="string" required>
  Explanation attached to the decline decision.
</ParamField>

### Returns

Returns the updated [Leave Request object](/reference/leave-requests/object).

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "lvr_6r3wLwX44s0Ak0bDkP5n2r7Q",
    "status": "declined",
    "leave": {
      "id": "lv_1HPCXADYAhh5k1NMU0r1WUqs",
      "type": "vacation",
      "worker": "wr_CgcLakmx4guire",
      "starts": "2026-04-14",
      "ends": "2026-04-16",
      "days": 2.5,
      "hours": 20,
      "schedule": {
        "2026-04-14": 8,
        "2026-04-15": 8,
        "2026-04-16": 4
      },
      "note": "Annual vacation"
    },
    "created": "2026-03-10T18:42:11Z",
    "updated": "2026-03-11T09:05:52Z"
  }
  ```
</ResponseExample>