Skip to main content
GET
Get persona detail for a user

Authorizations

X-API-Key
string
header
required

Domain-scoped API key. Generate and manage keys from the API Keys page in Settings.

Accepted in two forms:

  • X-API-Key: <key> header (preferred)
  • Authorization: Bearer <key> header (also accepted)

Path Parameters

tuid
string<uuid>
required

Response

Persona detail (persona fields null when none has been generated yet), or a placeholder when the user is unknown

What the TOTAL persona page shows for this user. A tab your domain hides in TOTAL is left out here too: the identity_persona sections only it shows, or drift_drivers for the drift tab.

tuid
string<uuid>
schema_version
string | null

Shape of identity_persona: 2.0, or legacy for a persona generated before 2.0. Null when no persona has been generated yet.

identity_persona
object | null

The persona as generated, section by section. Its sections follow schema_version and can gain fields as the persona model grows.

user_info
object
persona_summary
object
cluster_spines
object[]

The clusters this user belongs to, one per directory lens.

case_status
object | null

The user's open case. Returned only to keys with cases:read.

watchlist
object | null

Why the user is on the watchlist, when they are.

drift_drivers
object

How the identity's behaviour moved in its latest drift scoring run, driver by driver, against its own past and its peers.