> ## Documentation Index > Fetch the complete documentation index at: https://docs.flowpayroll.ai/llms.txt > Use this file to discover all available pages before exploring further. # Remove the organisation's statutory leave policies > Every statutory type falls back to the default: the salary for the absent days is deducted and nothing is topped up. Returns the policies now in force, as the GET would. ## OpenAPI ````yaml /api-reference/specs/salary.json delete /organisation/leave openapi: 3.0.1 info: title: Salary Service description: >- Salary module API for FlowPayroll: organisation and employee calculation-method configuration, statutory leave policies, and a side-effect-free pro-rata calculation. Enums may gain values and objects may gain properties without a new version, so a client should ignore properties it does not know and treat an enum value it does not recognise as unsupported. version: v1 servers: - url: https://api.sandbox.flowpayroll.ai/v1/salary security: - X-Auth-Token: [] X-Org-Id: [] paths: /organisation/leave: delete: tags: - Statutory leave policies summary: Remove the organisation's statutory leave policies description: >- Every statutory type falls back to the default: the salary for the absent days is deducted and nothing is topped up. Returns the policies now in force, as the GET would. operationId: DeleteOrganisationStatutoryLeave responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/OrganisationStatutoryLeaveResponseResponseBody components: schemas: OrganisationStatutoryLeaveResponseResponseBody: type: object properties: message: $ref: '#/components/schemas/MessageWithTokenResponse' content: $ref: >- #/components/schemas/OrganisationStatutoryLeaveResponseContentResponse validationIssues: type: array items: $ref: '#/components/schemas/ValidationIssue' nullable: true additionalProperties: false MessageWithTokenResponse: type: object properties: text: type: string token: type: string tokenArguments: type: array items: $ref: '#/components/schemas/ValidationIssueArgument' nullable: true additionalProperties: false OrganisationStatutoryLeaveResponseContentResponse: type: object properties: data: $ref: '#/components/schemas/OrganisationStatutoryLeaveResponse' metadata: $ref: '#/components/schemas/ContentMetadataResponse' additionalProperties: false ValidationIssue: type: object properties: field: type: string reason: type: string reasonToken: type: string reasonTokenArguments: type: array items: $ref: '#/components/schemas/ValidationIssueArgument' nullable: true additionalProperties: false ValidationIssueArgument: type: object properties: name: type: string value: nullable: true additionalProperties: false OrganisationStatutoryLeaveResponse: type: object properties: policies: $ref: '#/components/schemas/StatutoryLeavePolicyDocument' isDefault: type: boolean description: True when the organisation has stored no policies. effective: $ref: '#/components/schemas/EffectiveStatutoryLeavePolicies' createdBy: type: string nullable: true createdDate: type: string nullable: true updatedBy: type: string nullable: true updatedDate: type: string nullable: true additionalProperties: false description: >- The organisation's statutory leave policies as stored, and what each type resolves to. ContentMetadataResponse: type: object properties: dateFormat: type: string dateTimeFormat: type: string paginationToken: type: string nullable: true additionalProperties: false StatutoryLeavePolicyDocument: type: object properties: sickness: $ref: '#/components/schemas/StatutoryLeavePolicyDto' familyLeave: $ref: '#/components/schemas/StatutoryLeavePolicyDto' byType: $ref: '#/components/schemas/StatutoryLeaveTypePolicies' additionalProperties: false description: >- What happens to a salaried employee's salary on the days they are paid statutory pay, for an organisation or as one employee's override. `sickness` covers `StatutorySickPay`. `familyLeave` covers `StatutoryMaternityPay`, `StatutoryPaternityPay`, `StatutoryAdoptionPay`, `StatutorySharedParentalPay`, `StatutoryParentalBereavementPay` and `StatutoryNeoNatalCarePay`. `byType` sets an exception for one of those six. Every part is optional; for each type the first that is set applies: the employee's `byType` entry, the employee's family, the organisation's `byType` entry, the organisation's family, then the default (the salary for the days on leave is deducted and nothing is topped up). EffectiveStatutoryLeavePolicies: type: object properties: StatutorySickPay: $ref: '#/components/schemas/EffectiveStatutoryLeavePolicyResponse' StatutoryMaternityPay: $ref: '#/components/schemas/EffectiveStatutoryLeavePolicyResponse' StatutoryPaternityPay: $ref: '#/components/schemas/EffectiveStatutoryLeavePolicyResponse' StatutoryAdoptionPay: $ref: '#/components/schemas/EffectiveStatutoryLeavePolicyResponse' StatutorySharedParentalPay: $ref: '#/components/schemas/EffectiveStatutoryLeavePolicyResponse' StatutoryParentalBereavementPay: $ref: '#/components/schemas/EffectiveStatutoryLeavePolicyResponse' StatutoryNeoNatalCarePay: $ref: '#/components/schemas/EffectiveStatutoryLeavePolicyResponse' additionalProperties: false description: >- The policy every statutory type resolves to, one field per type, so a client never re-implements the cascade. StatutoryLeavePolicyDto: type: object properties: salaryTreatment: enum: - DeductAbsentDays - FullPay type: string description: >- `DeductAbsentDays` (the default): the salary for the days on leave is taken back with a separate line, so the statutory payment replaces it, and `topUp` can raise those days to a share of salary for part of the leave, in tiers. `FullPay`: the days on leave are taken back and topped up to 100%, statutory pay included, for the whole of the leave, so the employee is paid as though they were at work. nullable: true topUp: $ref: '#/components/schemas/StatutoryLeaveTopUpDto' additionalProperties: false description: What happens to the salary on the days a statutory type pays for. StatutoryLeaveTypePolicies: type: object properties: StatutoryMaternityPay: $ref: '#/components/schemas/StatutoryLeavePolicyDto' StatutoryPaternityPay: $ref: '#/components/schemas/StatutoryLeavePolicyDto' StatutoryAdoptionPay: $ref: '#/components/schemas/StatutoryLeavePolicyDto' StatutorySharedParentalPay: $ref: '#/components/schemas/StatutoryLeavePolicyDto' StatutoryParentalBereavementPay: $ref: '#/components/schemas/StatutoryLeavePolicyDto' StatutoryNeoNatalCarePay: $ref: '#/components/schemas/StatutoryLeavePolicyDto' additionalProperties: false description: >- One optional policy per family-leave type. Keyed by the statutory type's own name, as the statutory service spells it, so a generated client gets one typed field per type rather than an open map a typo can slip into. EffectiveStatutoryLeavePolicyResponse: type: object properties: policy: $ref: '#/components/schemas/StatutoryLeavePolicyDto' source: enum: - Default - Organisation - Employee type: string description: >- `Employee` (the employee's override), `Organisation` (the organisation's policies) or `Default` (nothing is set, so the absent days are deducted and nothing is topped up). additionalProperties: false description: The policy in force for one statutory type and where it came from. StatutoryLeaveTopUpDto: type: object properties: tiers: type: array items: $ref: '#/components/schemas/StatutoryLeaveTopUpTierDto' description: >- Applied back to back from the first day of the statutory payment: the first tier's duration, then the next tier's, and so on; days after the last tier get no top-up. The tiers must end within 52 weeks of the start of the leave. nullable: true additionalProperties: false StatutoryLeaveTopUpTierDto: type: object properties: duration: $ref: '#/components/schemas/DurationDto' percentOfSalary: type: number description: >- The share of salary the employee receives for those days in total, statutory pay included, 1 to 100. 100 pays the days as though they were at work. format: double nullable: true additionalProperties: false description: >- One tier of a top-up: how much of the leave it covers (`duration`) and the share of salary paid for those days (`percentOfSalary`). DurationDto: type: object properties: value: type: integer description: How many units, at least 1. For `Week`, 1 to 52. format: int32 nullable: true unit: $ref: '#/components/schemas/DurationUnit' additionalProperties: false description: >- A length of time, as a whole number of units, e.g. `{ "value": 6, "unit": "Week" }`. DurationUnit: enum: - Week type: string description: >- The unit a `duration` is counted in. `Week`: seven days. New units may be added, so a client should treat one it does not recognise as unsupported rather than as an error. securitySchemes: X-Auth-Token: type: apiKey description: FlowPayroll JWT (raw token, no Bearer prefix) name: X-Auth-Token in: header X-Org-Id: type: apiKey description: >- Organisation to scope the request to. Required when the principal can access more than one organisation; optional for single-organisation principals (the authorizer resolves it automatically). name: X-Org-Id in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.