---
title: "Delete user"
method: DELETE
path: "/v1/users/{identifyId}"
tags: ["Users"]
---

# Delete user

`DELETE /v1/users/{identifyId}`

## Request

- Base URL: `https://app.aptrinsic.com`
- URL: `https://app.aptrinsic.com/v1/users/{identifyId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/docs/v1/users/:identifyId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes a user
### HardDelete:
Default behavior is to mark the user as deleted, which will cause it to be hidden in the application.
If a user with the same id is created or updated within the next 7 days, 
the previously deleted record will be revived with all of its associated event history.
Conversely, if a user with the same ID is created after 7 days, a totally new record with no event history will be created.
To disable the current record from being revived in the future, set the hardDelete flag to true

## Path parameters

- `identifyId` string, required

## Query parameters

- `hardDelete` boolean

## Response `200`

Deleted

- ResponseEntity
  - `body` object
  - `statusCode` '100' | '101' | '102' | '103' | '200' | '201' | '202' | '203' | '204' | '205' | '206' | '207' | '208' | '226' | '300' | '301' | '302' | '303' | '304' | '305' | '307' | '308' | '400' | '401' | '402' | '403' | '404' | '405' | '406' | '407' | '408' | '409' | '410' | '411' | '412' | '413' | '414' | '415' | '416' | '417' | '418' | '419' | '420' | '421' | '422' | '423' | '424' | '426' | '428' | '429' | '431' | '451' | '500' | '501' | '502' | '503' | '504' | '505' | '506' | '507' | '508' | '509' | '510' | '511'
  - `statusCodeValue` integer

## Other responses

- `204`: No Content
- `401`: Unauthorized or bad API Key
- `404`: User not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api.md) - [All operations](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/revisions/e7b197b373d8?raw)