Skip to main content
DELETE
/
v1
/
people
/
{personId}
Delete a person
curl --request DELETE \
  --url https://api.folk.app/v1/people/{personId} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "per_183ed5cc-3182-45de-84d1-d520f2604810"
  }
}
This action is not reversible. When removing a person from the workspace, all of their information is deleted, including their custom field values, notes, and any associations with groups, companies, and other entities.

Authorizations

​
Authorization
string
header
required

API key for authentication

Path Parameters

​
personId
string
required

The ID of the person to delete.

Required string length: 40

Response

The ID of the deleted person.

​
data
object
required
Example:
{
  "id": "per_183ed5cc-3182-45de-84d1-d520f2604810"
}
​
deprecations
string[]
Example:
["This field is deprecated"]