---
title: "Remove leave information"
method: POST
path: "/people/{personId}/clear-leave"
tags: ["People"]
---

# Remove leave information

`POST /people/{personId}/clear-leave`

## Request

- Base URL: `https://api.vanta.com`
- URL: `https://api.vanta.com/people/{personId}/clear-leave`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/vanta/apis/build-integrations/docs/people/:personId/clear-leave/post.ts> (a function with typed inputs; its response is checked against the schema)

Remove leave information on a person. The person will become active in Vanta, and will be considered in certain tests related to personnel.

## Path parameters

- `personId` string, required

## Response `200`

Ok

- Person
  - `id` string, required
  - `userId` string, nullable, required: The ID of the Vanta user account associated with this person, if one exists.
  - `emailAddress` string, required
  - `employment` object, required
    - `status` 'UPCOMING' | 'CURRENT' | 'ON_LEAVE' | 'INACTIVE' | 'FORMER', required: The employment status of a person: - UPCOMING: The person is not yet employed and will start employment in the future. - CURRENT: The person is currently employed. - ON_LEAVE: The person is on leave. - INACTIVE: The person's employment is inactive. - FORMER: The person was previously employed.
    - `startDate` string, date-time, required: The date the person's employment started.
    - `jobTitle` string, nullable, required: The person's job title.
    - `endDate` string, date-time, nullable, required: If present, the date the person's employment ended.
  - `leaveInfo` LeaveInfo, required
    - `startDate` string, date-time, required: The start of the person's leave.
    - `endDate` string, date-time, nullable, required: The end of the person's leave. Null endDate implies indefinite leave.
    - `status` 'ACTIVE' | 'UPCOMING', required: User can be active or upcoming leave period
  - `groupIds` string[], required: The id of each group the user belongs to. This includes both manually created groups in Vanta and groups imported from an identity provider.
  - `name` object, required
    - `first` string, nullable, required: The person's first (given) name.
    - `last` string, nullable, required: The person's last (family) name.
    - `display` string, required: The person's display name, used in Vanta.
  - `sources` object, required: The sources of the person's information.
    - `employment` object, required
      - `endDate` union, required: The source of the person's information.
        - VantaBasedPersonInfoSource: The person's information comes from what is set in Vanta.
          - `type` 'VANTA', required
        - ScimBasedPersonInfoSource: The person's information comes from SCIM.
          - `type` 'SCIM', required
        - IntegrationBasedPersonInfoSource: The person's information comes from an integration.
          - `integrationId` string, required
          - `resourceId` string, nullable, required
          - `type` 'INTEGRATION', required
      - `startDate` union, required: The source of the person's information.
        - VantaBasedPersonInfoSource: The person's information comes from what is set in Vanta.
          - `type` 'VANTA', required
        - ScimBasedPersonInfoSource: The person's information comes from SCIM.
          - `type` 'SCIM', required
        - IntegrationBasedPersonInfoSource: The person's information comes from an integration.
          - `integrationId` string, required
          - `resourceId` string, nullable, required
          - `type` 'INTEGRATION', required
    - `emailAddress` union, required: The source of the person's information.
      - VantaBasedPersonInfoSource: The person's information comes from what is set in Vanta.
        - `type` 'VANTA', required
      - ScimBasedPersonInfoSource: The person's information comes from SCIM.
        - `type` 'SCIM', required
      - IntegrationBasedPersonInfoSource: The person's information comes from an integration.
        - `integrationId` string, required
        - `resourceId` string, nullable, required
        - `type` 'INTEGRATION', required
  - `tasksSummary` object, required: The person's tasks summary, which aggregates their current status across all of their relevant tasks.
    - `details` TaskSummaryDetails, required: All detailed information about a person's tasks, split across task categories.
      - `completeTrainings` CompleteTrainingsTaskSummary, required: Task summary for completing all trainings.
        - `taskType` 'COMPLETE_TRAININGS', required
        - `status` 'COMPLETE' | 'DUE_SOON' | 'OVERDUE' | 'NONE', required: The status of a task. - COMPLETE: The task has been completed. - DUE_SOON: The task is due soon. - OVERDUE: The task is overdue. - NONE: The task is not assigned.
        - `dueDate` string, date-time, nullable, required: The due date of the task.
        - `completionDate` string, date-time, nullable, required: The date the task was completed.
        - `disabled` object, nullable, required: If the task is disabled, the reason and date when it was disabled.
          - `date` string, date-time, required
          - `reason` string, nullable, required
        - `incompleteTrainings` Training[], required: Incomplete security trainings that are relevant given a person's requirements.
          - `name` string, required
        - `completedTrainings` Training[], required: Security trainings that have been completed and are relevant given a person's current requirements.
          - `name` string, required
      - `acceptPolicies` AcceptPoliciesTaskSummary, required: Policy acceptance details for a person.
        - `taskType` 'ACCEPT_POLICIES', required
        - `status` 'COMPLETE' | 'DUE_SOON' | 'OVERDUE' | 'NONE', required: The status of a task. - COMPLETE: The task has been completed. - DUE_SOON: The task is due soon. - OVERDUE: The task is overdue. - NONE: The task is not assigned.
        - `dueDate` string, date-time, nullable, required: The due date of the task.
        - `completionDate` string, date-time, nullable, required: The date the task was completed.
        - `disabled` object, nullable, required: If the task is disabled, the reason and date when it was disabled.
          - `date` string, date-time, required
          - `reason` string, nullable, required
        - `unacceptedPolicies` object[], required: Unaccepted policies that are relevant to the person.
          - `name` string, required
        - `acceptedPolicies` object[], required: Accepted policies that are relevant to the person.
          - `name` string, required
      - `completeCustomTasks` CompleteCustomTasksTaskSummary, required: Task summary for completing all custom tasks.
        - `taskType` 'COMPLETE_CUSTOM_TASKS', required
        - `status` 'COMPLETE' | 'DUE_SOON' | 'OVERDUE' | 'NONE', required: The status of a task. - COMPLETE: The task has been completed. - DUE_SOON: The task is due soon. - OVERDUE: The task is overdue. - NONE: The task is not assigned.
        - `dueDate` string, date-time, nullable, required: The due date of the task.
        - `completionDate` string, date-time, nullable, required: The date the task was completed.
        - `disabled` object, nullable, required: If the task is disabled, the reason and date when it was disabled.
          - `date` string, date-time, required
          - `reason` string, nullable, required
        - `incompleteCustomTasks` CustomTask[], required: Incomplete custom tasks that are relevant given a person's requirements.
          - `name` string, required
        - `completedCustomTasks` CustomTask[], required: Custom tasks that have been completed and are relevant given a person's current requirements.
          - `name` string, required
      - `completeOffboardingCustomTasks` CompleteOffboardingCustomTasksTaskSummary, required: Task summary for completing all offboarding custom tasks.
        - `taskType` 'COMPLETE_CUSTOM_OFFBOARDING_TASKS', required
        - `status` 'COMPLETE' | 'DUE_SOON' | 'OVERDUE' | 'NONE', required: The status of a task. - COMPLETE: The task has been completed. - DUE_SOON: The task is due soon. - OVERDUE: The task is overdue. - NONE: The task is not assigned.
        - `dueDate` string, date-time, nullable, required: The due date of the task.
        - `completionDate` string, date-time, nullable, required: The date the task was completed.
        - `disabled` object, nullable, required: If the task is disabled, the reason and date when it was disabled.
          - `date` string, date-time, required
          - `reason` string, nullable, required
        - `incompleteCustomOffboardingTasks` CustomTask[], required: Incomplete custom tasks that are relevant given a person's requirements.
          - `name` string, required
        - `completedCustomOffboardingTasks` CustomTask[], required: Custom tasks that have been completed and are relevant given a person's current requirements.
          - `name` string, required
      - `installDeviceMonitoring` InstallDeviceMonitoringTaskSummary, required: Task summary for installing device monitoring.
        - `taskType` 'INSTALL_DEVICE_MONITORING', required
        - `status` 'COMPLETE' | 'DUE_SOON' | 'OVERDUE' | 'NONE', required: The status of a task. - COMPLETE: The task has been completed. - DUE_SOON: The task is due soon. - OVERDUE: The task is overdue. - NONE: The task is not assigned.
        - `dueDate` string, date-time, nullable, required: The due date of the task.
        - `completionDate` string, date-time, nullable, required: The date the task was completed.
        - `disabled` object, nullable, required: If the task is disabled, the reason and date when it was disabled.
          - `date` string, date-time, required
          - `reason` string, nullable, required
      - `completeBackgroundChecks` CompleteBackgroundChecksTaskSummary, required: Task summary for completing background checks.
        - `taskType` 'COMPLETE_BACKGROUND_CHECKS', required
        - `status` 'COMPLETE' | 'DUE_SOON' | 'OVERDUE' | 'NONE', required: The status of a task. - COMPLETE: The task has been completed. - DUE_SOON: The task is due soon. - OVERDUE: The task is overdue. - NONE: The task is not assigned.
        - `dueDate` string, date-time, nullable, required: The due date of the task.
        - `completionDate` string, date-time, nullable, required: The date the task was completed.
        - `disabled` object, nullable, required: If the task is disabled, the reason and date when it was disabled.
          - `date` string, date-time, required
          - `reason` string, nullable, required
    - `status` 'COMPLETE' | 'DUE_SOON' | 'NONE' | 'OFFBOARDING_COMPLETE' | 'OFFBOARDING_DUE_SOON' | 'OFFBOARDING_OVERDUE' | 'OVERDUE' | 'PAUSED', required: The overall status of a person's outstanding tasks: - NONE: There are no tasks. - DUE_SOON: At least one task is due soon. - OVERDUE: At least one task is overdue. Has a higher priority than DUE_SOON. - COMPLETE: All tasks are complete. - PAUSED: All tasks are paused. - OFFBOARDING_DUE_SOON: At least one offboarding task is due soon. - OFFBOARDING_OVERDUE: At least one offboarding task is overdue. Has a higher priority than OFFBOARDING_DUE_SOON. - OFFBOARDING_COMPLETE: All offboarding tasks are complete.
    - `dueDate` string, date-time, nullable, required: The due date of the person's earliest-due task.
    - `completionDate` string, date-time, nullable, required: The date when person's tasks were completed.

---

[API](https://skmtc.dev/vanta/apis/build-integrations.md) - [All operations](https://skmtc.dev/vanta/apis/build-integrations/llms.txt) - [OpenAPI document](https://skmtc.dev/vanta/apis/build-integrations/revisions/6c1f7590538b?raw)