v1

latestOpenAPI 3.0.1Vanta Terms of Service2026-07-26327517821.8 KB

People

Set leave information

Set leave information on a person. A person on leave is inactive in Vanta and will not be considered in certain personnel-related tests. If the person has existing leave information, it will be cleared and replaced.

post/people/{personId}/set-leave

Path parameters

personIdstring required

Request body

endDatestring date-time nullable required

The end date of the person's leave. If left empty, the leave is considered indefinite.

startDatestring date-time required

The start date of the person's leave.

Response

idstring required

userIdstring nullable required

The ID of the Vanta user account associated with this person, if one exists.

emailAddressstring required

groupIdsstring[] 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.