Users

Manage user identities and profiles.

Get User

GET /v1/users/:user_id

Retrieve a user's profile and traits.

Response

{
  "success": true,
  "data": {
    "user_id": "user_456",
    "email": "[email protected]",
    "traits": {
      "name": "Jane Doe",
      "company": "Acme Inc",
      "plan": "enterprise"
    },
    "created_at": "2024-01-01T00:00:00Z",
    "last_seen": "2024-01-15T10:30:00Z"
  }
}

Update User

PATCH /v1/users/:user_id

Update a user's traits.

Request Body

{
  "traits": {
    "plan": "enterprise",
    "company_size": 500
  }
}

List Users

GET /v1/users

Retrieve a list of users.

Query Parameters

Parameter	Type	Description
email	string	Filter by email
trait	string	Filter by trait (e.g., plan:enterprise)
limit	integer	Max results (default: 100)

Delete User

DELETE /v1/users/:user_id

Delete a user and all associated data (GDPR compliance).