CognitiveX Docs
API

GET /api/introspect/personality/history

Get Personality History

GET /api/introspect/personality/history

Get Personality History

Authentication: Authorization: Bearer <key> or X-API-Key: <key>. Create keys at developers.cognitivx.io/keys.

Parameters

NameInTypeRequiredDescription
traitquerystringYesTrait name from ALL_TRAITS
daysqueryintegerNoLookback window in days Defaults to 30.
X-Org-IDheaderstring | nullNo-

Example request

curl -X GET https://api.cognitivx.io/api/introspect/personality/history \
  -H "Authorization: Bearer icog_..."

Example response

200 application/json

{
  "trait": "string",
  "dimension": "string",
  "days": 1,
  "snapshots": [
    {
      "alpha": 0,
      "beta": 0,
      "mean": 0,
      "n_observations": 0,
      "snapshot_at": "2026-06-16T08:30:00Z"
    }
  ],
  "events": [
    {
      "delta": 0,
      "prior_mean": 0,
      "new_mean": 0,
      "n_observations": 0,
      "trigger_event_type": "semantic",
      "trigger_conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created_at": "2026-06-16T08:30:00Z"
    }
  ]
}

Responses

StatusDescription
200Success. Returns the response body shown below.
422Request validation failed. detail lists each offending field.