---
title: "Offboard people"
method: POST
path: "/people/offboard"
tags: ["People"]
---

# Offboard people

`POST /people/offboard`

Offboard a list of people. A person is only eligible for offboarding completion when:
1. They are an ex-employee.
2. All of the person's monitored accounts are deactivated or manually overwritten as such.
3. All of a person's custom offboarding tasks have been completed.
All of the person's unmonitored accounts will be automatically marked as deactivated when they
are offboarded. If the person has unfinished offboarding tasks those will NOT automatically be
completed and offboarding them will fail.

## Request body

- object
  - `updates` object[], required — List of the people to offboard.
    - `acknowledgerId` string, required — ID of the person who will be recorded as completing the offboarding for these people
    - `id` string, required — ID of the person to offboard

## Response `200`

Ok

- BulkResponse
  - `results` UpdateResponse[], required — List of results matching the length and order of the request
    - union
      - SuccessResponse
        - `id` string, required — Id of the record
        - `status` 'SUCCESS', required
      - NonSuccessResponse
        - `id` string, required — Id of the record
        - `status` 'ERROR', required
        - `message` string, required — Message an error message

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/versions/6c1f7590538b/schema)