> ## 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. # Set an employee's auto-enrolment exemption > Marks an employee as exempt from the automatic enrolment and cyclical re-enrolment duties. While an exemption is in place the employee is not assessed and is never automatically enrolled; they may still opt in or be enrolled manually. Reasons follow The Pensions Regulator's exceptions to the employer duties: Director, OfficeHolder, LlpMember, TaxProtection, CeasedMembershipWithinTwelveMonths, WindingUpLumpSum, NoticeOfTermination. ## OpenAPI ````yaml /api-reference/specs/pension-v2.json put /auto-enrolment-exemption openapi: 3.0.4 info: title: FlowPayroll Pension API version: v2 servers: - url: https://api.sandbox.flowpayroll.ai/v2/pension security: [] tags: - name: Pension providers description: >- Look up the pension providers available to your organisation. Providers are set up in the product, so the API exposes them read-only. - name: Pension schemes description: >- Your organisation's arrangements with providers. Scheme endpoints use the /pension-schema path. - name: Pension groups description: >- Contribution rule sets within a scheme: pension type, contribution basis, and employee and employer factors. - name: Employee enrolment description: >- Associate employees with pension groups, remove associations, and send enrolment letters. - name: Pension information description: >- An employee's full pension picture in one call: composition, latest assessment, and postponement. - name: Auto-enrolment description: >- Assessment results per pay run, employees with outstanding or no auto-enrolment, and a stateless assessment preview. - name: Postponement description: Defer auto-enrolment per employee, overriding the organisation defaults. - name: Organisation defaults description: >- The organisation's default pension group, postponement definitions, and auto-enrolment mode. - name: Pension calculations description: >- Per-period contribution amounts, the contributions CSV, and provider export files. - name: Provider submissions description: >- Send a completed pay run to its connected pension provider, approve the payment, and read back what the provider reported: opt-outs, stopped contributions, refunds and schedules. paths: /auto-enrolment-exemption: put: tags: - AutoEnrolmentExemption summary: Set an employee's auto-enrolment exemption description: >- Marks an employee as exempt from the automatic enrolment and cyclical re-enrolment duties. While an exemption is in place the employee is not assessed and is never automatically enrolled; they may still opt in or be enrolled manually. Reasons follow The Pensions Regulator's exceptions to the employer duties: Director, OfficeHolder, LlpMember, TaxProtection, CeasedMembershipWithinTwelveMonths, WindingUpLumpSum, NoticeOfTermination. operationId: PutEmployeeAutoEnrolmentExemption requestBody: content: application/json: schema: $ref: '#/components/schemas/SubmitEmployeeAutoEnrolmentExemptionRequest' required: true responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/EmployeeAutoEnrolmentExemptionResponseBody '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' components: schemas: SubmitEmployeeAutoEnrolmentExemptionRequest: required: - employeeId - reason type: object properties: employeeId: type: string nullable: true reason: enum: - Director - OfficeHolder - LlpMember - TaxProtection - CeasedMembershipWithinTwelveMonths - WindingUpLumpSum - NoticeOfTermination type: string description: |- One of The Pensions Regulator's exceptions to the employer duties. Anything outside the published values is refused with a 400 listing the choices. nullable: true note: type: string description: |- Optional free-text evidence or context, e.g. which HMRC protection certificate was seen. nullable: true additionalProperties: false description: |- Sets (or replaces) an employee's auto-enrolment exemption. One exemption per employee: submitting again overwrites the reason and note. EmployeeAutoEnrolmentExemptionResponseBody: required: - message type: object properties: message: $ref: '#/components/schemas/MessageWithTokenResponse' content: $ref: '#/components/schemas/EmployeeAutoEnrolmentExemptionContentResponse' validationIssues: type: array items: $ref: '#/components/schemas/ValidationIssue' nullable: true errors: type: array items: $ref: '#/components/schemas/Error' description: >- Deprecated: the same issues as `validationIssues` (`reasonText` is `reason`, `reasonId` is `reasonToken`, `reasonParameters` is `reasonTokenArguments`). Read `validationIssues`; this will be removed. nullable: true readOnly: true deprecated: true metadata: allOf: - $ref: '#/components/schemas/ContentMetadataResponse' description: >- Deprecated: the same values as `content.metadata`. Read that; this will be removed. deprecated: true additionalProperties: false description: >- The response envelope every FlowPayroll API answers with: a `message`, the `content`, and any `validationIssues`. `errors` and the top-level `metadata` are deprecated copies of `validationIssues` and `content.metadata`, and will be removed. ObjectResponseBody: required: - message type: object properties: message: $ref: '#/components/schemas/MessageWithTokenResponse' content: $ref: '#/components/schemas/ObjectContentResponse' validationIssues: type: array items: $ref: '#/components/schemas/ValidationIssue' nullable: true errors: type: array items: $ref: '#/components/schemas/Error' description: >- Deprecated: the same issues as `validationIssues` (`reasonText` is `reason`, `reasonId` is `reasonToken`, `reasonParameters` is `reasonTokenArguments`). Read `validationIssues`; this will be removed. nullable: true readOnly: true deprecated: true metadata: allOf: - $ref: '#/components/schemas/ContentMetadataResponse' description: >- Deprecated: the same values as `content.metadata`. Read that; this will be removed. deprecated: true additionalProperties: false description: >- The response envelope every FlowPayroll API answers with: a `message`, the `content`, and any `validationIssues`. `errors` and the top-level `metadata` are deprecated copies of `validationIssues` and `content.metadata`, and will be removed. MessageWithTokenResponse: required: - token type: object properties: text: type: string nullable: true token: type: string description: >- Stable snake_case key for the message, for clients that translate it. nullable: true tokenArguments: type: array items: $ref: '#/components/schemas/ValidationIssueArgument' nullable: true textId: type: string description: >- Deprecated: the same value as `token`. Read that; this will be removed. nullable: true readOnly: true deprecated: true textParameters: type: array items: $ref: '#/components/schemas/Pair' description: >- Deprecated: the same values as `tokenArguments`. Read that; this will be removed. nullable: true readOnly: true deprecated: true additionalProperties: false description: >- What happened, as English `text` and a stable `token` to translate from. `textId` and `textParameters` are deprecated copies of `token` and `tokenArguments`. EmployeeAutoEnrolmentExemptionContentResponse: type: object properties: data: $ref: '#/components/schemas/EmployeeAutoEnrolmentExemption' metadata: $ref: '#/components/schemas/ContentMetadataResponse' additionalProperties: false ValidationIssue: type: object properties: field: type: string nullable: true reason: type: string nullable: true reasonToken: type: string nullable: true reasonTokenArguments: type: array items: $ref: '#/components/schemas/ValidationIssueArgument' nullable: true additionalProperties: false Error: type: object properties: field: type: string nullable: true reasonText: type: string nullable: true reasonId: type: string nullable: true reasonParameters: type: array items: $ref: '#/components/schemas/Pair' nullable: true additionalProperties: false description: >- Deprecated: an entry of the old `errors` list. Read `validationIssues` instead. deprecated: true ContentMetadataResponse: type: object properties: dateFormat: type: string nullable: true dateTimeFormat: type: string nullable: true paginationToken: type: string nullable: true additionalProperties: false ObjectContentResponse: type: object properties: data: nullable: true metadata: $ref: '#/components/schemas/ContentMetadataResponse' additionalProperties: false ValidationIssueArgument: type: object properties: name: type: string nullable: true value: nullable: true additionalProperties: false Pair: type: object properties: key: type: string nullable: true value: type: string nullable: true additionalProperties: false description: >- Deprecated: a key and value of the old `textParameters` and `reasonParameters`. deprecated: true EmployeeAutoEnrolmentExemption: required: - employeeId - organisationId - reason type: object properties: organisationId: type: string nullable: true employeeId: type: string nullable: true reason: enum: - Director - OfficeHolder - LlpMember - TaxProtection - CeasedMembershipWithinTwelveMonths - WindingUpLumpSum - NoticeOfTermination type: string description: >- The Pensions Regulator exception the exemption rests on: "Director" (no contract of employment, so not a worker), "OfficeHolder", "LlpMember", "TaxProtection" (HMRC protection the employer has reasonable grounds to believe in), "CeasedMembershipWithinTwelveMonths", "WindingUpLumpSum" or "NoticeOfTermination". nullable: true note: type: string description: >- Free-text evidence or context, e.g. which HMRC protection certificate was seen. Shown on the employee's pension record. nullable: true additionalProperties: false description: >- A per-employee exemption from the automatic enrolment and cyclical re-enrolment duties. While one is in place the employee is never assessed or automatically enrolled, and stops appearing in the not-complete auto-enrolment listing; they keep the right to join, so manual enrolment and opt-in work as normal. Deleting the exemption resumes assessment on the next pay run. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.