Request leave

Submit and track employee leave requests via the HR API.

Include acting-client headers on product API calls: X-Workspace-Id and X-Acting-Company-Id. See Act as a client.

Prerequisites

Leave policy configured

Required permissions: hr:leave:write.

Steps

1

Create leave request

curl -sS -X POST "$FLUIDE_BASE_URL/api/v1/hr/leave/requests" \
  -H "Authorization: Bearer $FLUIDE_ACCESS_TOKEN" \
  -H "X-Fluide-Api-Key: $FLUIDE_API_KEY" \
  -H "X-Fluide-Client-Id: fluide-developer" \
  -H "X-Workspace-Id: $FLUIDE_WORKSPACE_ID" \
  -H "X-Acting-Company-Id: $FLUIDE_COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{"employeeId":"'$EMPLOYEE_ID'","leaveTypeId":"'$LEAVE_TYPE_ID'","startDate":"2026-08-01","endDate":"2026-08-05"}'

configure leave policy