# Purge an Individual

The Purge Individual endpoint allows you to initiate a permanent deletion of an individual and all of their associated data from MeasureOne's systems. This operation is designed to help you meet right to erasure requests.
Once the request is received, MeasureOne queues the purge process and permanently deletes the individual's data within 120 hours (5 days). During this period, all records linked to the individual are marked for removal and will no longer be available for processing or retrieval.
You can optionally provide delivery details (webhooks) to receive an asynchronous notification (individual.purged) when the purge operation is complete.


Endpoint: POST /v3/compliance/purge_individual
Version: 3.0
Security: Bearer

## Header parameters:

  - `version` (number)
    Version number of the MeasureOne API you wish to integrate.

  - `Authorization` (string)
    Authorization API Key. Provide Purge Token.

  - `Content-type` (string)
    Content-type of the request payload. MeasureOne accepts content in application/json format unless specified otherwise

## Request fields (application/json):

  - `individual_id` (string, required)
    Unique ID of the Individual identified by MeasureOne

  - `delivery_details` (array)
    List of endpoints to which the [webhooks](#tag/webhooks) should be delivered

  - `delivery_details.event_type` (string, required)
    Event for which you want a notification.
    Enum: "individual.purged"

  - `delivery_details.url` (string, required)
    URL to which the webhook should be delivered

  - `delivery_details.headers` (object)
    Additional http headers that you may want to pass. MeasureOne will send the data with content-type as
    Example: {"content-type":"application/json"}

  - `delivery_details.x_auth_token_credentials` (object)
    MeasureOne will generate the authorization token with provided auth token credentials and use the generated token while delivering webhooks.  details can be provided when a fresh authorization token needs to be used when MeasureOne delivers webhook.

  - `delivery_details.x_auth_token_credentials.token_type` (string, required)
    Type of token
    Enum: "JWT"

  - `delivery_details.x_auth_token_credentials.http_method` (string, required)
    Type of HTTP method
    Enum: "POST"

  - `delivery_details.x_auth_token_credentials.url` (string, required)
    Endpoint url to generate auth token

  - `delivery_details.x_auth_token_credentials.key_id` (string)
    Unique ID of the Encryption key identified by MeasureOne.  holds credentials details. So,  header and  can be provided in encrypted form. When  is provided then  header and attributes value in  object will be treated as encrypted. Please reach out to us on support@mesureone.com to get your encryption key_id setup.

  - `delivery_details.x_auth_token_credentials.headers` (object)
    Request body headers that you may want to pass while calling endpoint.

MeasureOne supports two content-type  and  for generate auth token endpoint. An unspecified content-type will default to

  - `delivery_details.x_auth_token_credentials.data` (object)
    Data that we need to pass in body while calling endpoint. attribute's value can be pass in encrypted form when  is provided.

  - `delivery_details.x_auth_token_credentials.response_token_path` (string)
    Path from response for token attribute. When  is unspecified then complete response will be used as auth token.

## Response 400 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 401 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 404 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 405 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `error_code` (string)
    MeasureOne Error code
    Example: "METHOD_NOT_ALLOWED"

  - `error_message` (string)
    Details of the error
    Example: "Given Method not allowed"

  - `http_code` (number)
    Example: 405

## Response 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error