PersonRecord

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/PersonRecord",
  "title": "PersonRecord",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "readOnly": true,
      "description": "Numeric person ID."
    },
    "name": {
      "type": "string",
      "readOnly": true,
      "description": "Display name derived from person properties (email, name, or username)."
    },
    "distinct_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "readOnly": true
    },
    "properties": {
      "description": "Key-value map of person properties set via $set and $set_once operations."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "description": "When this person was first seen (ISO 8601)."
    },
    "uuid": {
      "type": "string",
      "format": "uuid",
      "readOnly": true,
      "description": "Unique identifier (UUID) for this person."
    },
    "last_seen_at": {
      "type": "string",
      "format": "date-time",
      "readOnly": true,
      "nullable": true,
      "description": "Timestamp of the last event from this person, or null."
    }
  },
  "required": [
    "created_at",
    "distinct_ids",
    "id",
    "last_seen_at",
    "name",
    "uuid"
  ]
}