Delete Person

delete/v1/people/{person_id}

Soft-deletes a person in the caller's workspace. Side effect: stamps deleted_at on the person row so it stops appearing in lists and reads. Returns no body.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
person_id	string <uuid>	Yes	Public UUID of the person.e.g. c4d5e6f7-8a9b-40c1-92d3-e4f5a6b7c8d9

Headers

Name	Type	Required	Description
Accept	string	No	Standard content negotiation. JSON is always returned for these resources.e.g. application/json

Request

cURL

curl -X DELETE https://api.wellapp.ai/v1/people/{person_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

204 — The person was soft-deleted.

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

403 — Forbidden

{
  "code": "FORBIDDEN",
  "status": 403,
  "title": "Forbidden",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not Found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}