Delete member

Permanently removes a member from the organization. This action cannot be undone. Supports both API key authentication (X-API-Key header) and session authentication (cookies + X-Organization-Id header).

DELETE /v1/people/{id}

Try it

Delete member

cURL

curl --request DELETE \
  --url http://localhost:3333/v1/people/{id} \
  --header 'X-API-Key: <api-key>'

200

{
  "success": true,
  "deletedMember": {
    "id": "mem_abc123def456",
    "name": "John Doe",
    "email": "[e-mail]"
  },
  "authType": "api-key"
}

Authorizations

X-API-Key · string · header · required

API key for authentication

Headers

X-Organization-Id · string

Organization ID (required for session auth, optional for API key auth)

Path Parameters

id · string · required

Member ID

Example:

"mem_abc123def456"

Response

200

application/json

Member deleted successfully

success · boolean

Indicates successful deletion

Example:

true

deletedMember · object

Show child attributes

deletedMember. id · string

The deleted member ID

Example:

"mem_abc123def456"

deletedMember. name · string

The deleted member name

Example:

"John Doe"

deletedMember. email · string

The deleted member email

Example:

"[e-mail]"

authType · enum<string>

How the request was authenticated

Available options: api-key, session