Highlight Session

Schema for a Highlight session as represented in the dashboard and emitted by SDK identify/initialize mutations.

ObservabilitySession ReplayError MonitoringAPMLoggingTracingOpenTelemetryOpen-SourceFrontend MonitoringFull Stack Monitoring

Properties

Name	Type	Description
id	integerstring	Numeric session identifier.
secure_id	string	URL-safe secure session identifier used in dashboard links.
project_id	string	Owning Highlight project (verbose) identifier.
identifier	string	Customer-supplied identifier passed to H.identify (e.g. user email).
fingerprint	string
user_object	object	Arbitrary user metadata supplied via H.identify second argument.
fields	array	Session properties added via H.addSessionProperties.
environment	string	Deployment environment (e.g. production, staging).
app_version	string
client_version	string
firstload_version	string
client_id	string
user_agent	string
city	string
country	string
language	string
started_at	string
last_active_at	string
active_length	integer	Active duration in milliseconds.
url	string	Direct link to the session in the Highlight dashboard.
events_count	integer
messages_count	integer
errors_count	integer
viewed	boolean
starred	boolean
excluded	boolean
processed	boolean
enable_strict_privacy	boolean

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.com/schemas/highlight-io/highlight-session-schema.json",
  "title": "Highlight Session",
  "description": "Schema for a Highlight session as represented in the dashboard and emitted by SDK identify/initialize mutations.",
  "type": "object",
  "required": ["secure_id", "project_id"],
  "properties": {
    "id": { "type": ["integer", "string"], "description": "Numeric session identifier." },
    "secure_id": { "type": "string", "description": "URL-safe secure session identifier used in dashboard links." },
    "project_id": { "type": "string", "description": "Owning Highlight project (verbose) identifier." },
    "identifier": { "type": "string", "description": "Customer-supplied identifier passed to H.identify (e.g. user email)." },
    "fingerprint": { "type": "string" },
    "user_object": {
      "type": "object",
      "description": "Arbitrary user metadata supplied via H.identify second argument.",
      "additionalProperties": true
    },
    "fields": {
      "type": "array",
      "description": "Session properties added via H.addSessionProperties.",
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "value": { "type": "string" },
          "type": { "type": "string", "enum": ["session", "user", "track"] }
        }
      }
    },
    "environment": { "type": "string", "description": "Deployment environment (e.g. production, staging)." },
    "app_version": { "type": "string" },
    "client_version": { "type": "string" },
    "firstload_version": { "type": "string" },
    "client_id": { "type": "string" },
    "user_agent": { "type": "string" },
    "city": { "type": "string" },
    "country": { "type": "string" },
    "language": { "type": "string" },
    "started_at": { "type": "string", "format": "date-time" },
    "last_active_at": { "type": "string", "format": "date-time" },
    "active_length": { "type": "integer", "description": "Active duration in milliseconds." },
    "url": { "type": "string", "format": "uri", "description": "Direct link to the session in the Highlight dashboard." },
    "events_count": { "type": "integer" },
    "messages_count": { "type": "integer" },
    "errors_count": { "type": "integer" },
    "viewed": { "type": "boolean" },
    "starred": { "type": "boolean" },
    "excluded": { "type": "boolean" },
    "processed": { "type": "boolean" },
    "enable_strict_privacy": { "type": "boolean" }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/highlight-session"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.