FAfactorialhr
Timeoff > Policy

Deletes a Policy

Changed on

Deletes a Policy

delete/api/2026-10-01/resources/timeoff/policies/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/timeoff/policies/{id}
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: time_off
    • or API key in header x-api-key

Path parameters

idstring required

Id of the policy to delete.

Response

OK

idstring required

The policy id.

namestring required

Policy name.

mainboolean

Whether this is the company's main (default) time off policy — the one employees fall under unless assigned a specific policy.

company_idstring required

ID of the company that owns this policy.

descriptionstring

The policy description.

Example response

{
  "id": "1",
  "name": "Policy for remotes",
  "main": true,
  "company_id": "1",
  "description": "This policy will apply only for remote employees"
}

Changes