Skip to main content
POST
/
v1
/
leave-entitlements
Create a leave entitlement
curl --request POST \
  --url https://api.plane.com/v1/leave-entitlements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "worker": "<string>",
  "policy": "<string>",
  "starts": "<string>",
  "ends": "<string>",
  "overrides": {}
}
'

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.

​
Parameters

​
worker
string
required
ID of the worker receiving the policy.
​
policy
string
required
ID of the leave policy to assign.
​
starts
string
Date when the entitlement begins. Defaults to today.
​
ends
string
Optional date when the entitlement ends.
​
overrides
object
Optional sparse policy overrides for this worker.

​
Returns

Returns the created Leave Entitlement object.