---
updatedAt: 2026-04-21T16:11:36.000Z
agentTools:
  projectIndex: https://apidoc.factorialhr.com/llms.txt
---

# Timeoff > Leave > Deletes

Subscription_type: `timeoff/leave/delete`

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Factorial API",
    "description": "",
    "version": "2026-10-01"
  },
  "webhooks": {
    "Webhooks > Timeoff > Leave > Deletes": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `timeoff/leave/delete`",
        "deprecated": false,
        "summary": "Timeoff > Leave > Deletes",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/timeoff_leave"
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://api.factorialhr.com",
      "description": "Production server"
    },
    {
      "url": "https://api.demo.factorial.dev",
      "description": "Demo server (deprecated)"
    },
    {
      "url": "https://api.eu2.demo.factorial.dev",
      "description": "Demo server"
    }
  ],
  "security": [
    {
      "oauth2": []
    }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://id.factorialhr.com/oauth/authorize",
            "tokenUrl": "https://id.factorialhr.com/api/oauth/token",
            "refreshUrl": "https://id.factorialhr.com/api/oauth/token",
            "scopes": {
              "read": "Required for all operations",
              "write": "Required for write operations",
              "approvals": "Access to approvals",
              "banking": "Access to banking",
              "company_holidays": "Access to company holidays",
              "company_legal_entities": "Access to company legal entities",
              "company_locations": "Access to company locations",
              "compensations": "Access to compensations",
              "contracts": "Access to contracts",
              "custom_fields": "Access to custom fields",
              "documents": "Access to documents",
              "employee_updates": "Access to employee updates",
              "employees": "Access to employees",
              "expenses": "Access to expenses",
              "finance": "Access to finance",
              "integrations": "Access to integrations",
              "it_management": "Access to it management",
              "job_catalog": "Access to job catalog",
              "marketplace": "Access to marketplace",
              "payroll": "Access to payroll",
              "payroll_supplements": "Access to payroll supplements",
              "performance": "Access to performance",
              "posts": "Access to posts",
              "processes": "Access to processes",
              "project_management_expenses": "Access to project management expenses",
              "project_management_projects": "Access to project management projects",
              "project_management_time": "Access to project management time",
              "recruitment": "Access to recruitment",
              "shift_management": "Access to shift management",
              "tasks": "Access to tasks",
              "time_off": "Access to time off",
              "time_tracking": "Access to time tracking",
              "trainings": "Access to trainings"
            }
          }
        }
      }
    },
    "schemas": {
      "timeoff_leave": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "employee_id",
          "start_on",
          "updated_at",
          "days_taken"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the Leave",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "ID of the company the leave belongs to",
            "example": "1"
          },
          "employee_id": {
            "type": "string",
            "description": "ID of the employee taking the leave",
            "example": "1"
          },
          "start_on": {
            "type": "string",
            "description": "First day of the leave",
            "example": "2028-09-05"
          },
          "finish_on": {
            "type": "string",
            "description": "Last day of the leave (inclusive); null while an open-ended leave has no end yet",
            "example": "2028-09-05"
          },
          "half_day": {
            "type": "string",
            "description": "Which half of the day a half-day leave covers — `beginning_of_day` or `end_of_day`; null for full-day leaves"
          },
          "description": {
            "type": "string",
            "description": "Free-text description of the leave",
            "example": "Annual family vacation"
          },
          "reason": {
            "type": "string",
            "description": "The reason provided by the employee for taking the leave",
            "example": "Medical appointment"
          },
          "leave_type_id": {
            "type": "string",
            "description": "ID of the leave type this leave is of",
            "example": "36"
          },
          "leave_type_name": {
            "type": "string",
            "description": "Denormalised name of the leave type"
          },
          "approved": {
            "type": "boolean",
            "description": "Tri-state approval status — true = approved, false = rejected, null = pending approval",
            "example": true
          },
          "employee_full_name": {
            "type": "string",
            "description": "The full name of the employee taking the leave",
            "example": "Bob The Boss"
          },
          "start_time": {
            "type": "string",
            "description": "The start time of the leave",
            "example": "09:00"
          },
          "hours_amount_in_cents": {
            "type": "integer",
            "description": "Total hours the leave consumes, in hundredths of an hour (e.g. 800 = 8 hours); set for hourly leaves",
            "example": 800
          },
          "updated_at": {
            "type": "string",
            "description": "The updated at date of the leave",
            "example": "2028-03-11T17:03:12.000Z"
          },
          "created_at": {
            "type": "string",
            "description": "The created at date of the leave",
            "example": "2028-03-11T17:03:12.000Z"
          },
          "deleted_at": {
            "type": "string",
            "description": "The date when the leave was deleted",
            "example": "2028-03-11T17:03:12.000Z"
          },
          "duration_attributes": {
            "type": "string",
            "description": "The duration attributes of the leave",
            "example": {
              "accrues_list": {
                "2028": 1
              },
              "workable_units": {
                "days": {
                  "2028": 1
                },
                "hours": {
                  "2028": 8
                }
              },
              "used_units": {
                "days": {
                  "2028": 1
                },
                "hours": {
                  "2028": 8
                }
              },
              "french_calendar_flag_enabled": false,
              "finish_on_natural": "2028-09-05"
            }
          },
          "duration_by_day_attributes": {
            "type": "object",
            "description": "Per-day breakdown of the leave's workable and used units, keyed by calendar date. Populated only when the read requests `include_duration_by_day=true`; null otherwise.",
            "properties": {
              "workable_units_by_day": {
                "type": "object",
                "properties": {
                  "days": {},
                  "hours": {}
                },
                "required": [
                  "days",
                  "hours"
                ]
              },
              "used_units_by_day": {
                "type": "object",
                "properties": {
                  "days": {},
                  "hours": {}
                },
                "required": [
                  "days",
                  "hours"
                ]
              }
            },
            "required": [
              "workable_units_by_day",
              "used_units_by_day"
            ]
          },
          "days_taken": {
            "type": "number",
            "description": "Number of days taken for paid leave. Reflects the summed per-day used total when the per-day breakdown is computed; otherwise the leave's calendar-day duration.",
            "example": 1
          }
        }
      }
    }
  }
}
```