PostHog · Schema

TracesQuery

A/B TestingAnalyticsFeature FlagsOpen SourceProduct AnalyticsSession Recording

Properties

Name	Type	Description
dateRange	object
filterSupportTraces	boolean
filterTestAccounts	boolean
groupKey	string
groupTypeIndex	integer
kind	string
limit	integer
modifiers	object	Modifiers used when performing the query
offset	integer
personId	string	Person who performed the event
properties	array	Properties configurable in the interface
randomOrder	boolean	Use random ordering instead of timestamp DESC. Useful for representative sampling to avoid recency bias.
response	object
showColumnConfigurator	boolean
tags	object
version	number	version of the node, used for schema migrations

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/TracesQuery",
  "title": "TracesQuery",
  "additionalProperties": false,
  "properties": {
    "dateRange": {
      "default": null,
      "allOf": [
        {
          "$ref": "#/components/schemas/DateRange"
        }
      ],
      "nullable": true
    },
    "filterSupportTraces": {
      "default": null,
      "title": "Filtersupporttraces",
      "type": "boolean",
      "nullable": true
    },
    "filterTestAccounts": {
      "default": null,
      "title": "Filtertestaccounts",
      "type": "boolean",
      "nullable": true
    },
    "groupKey": {
      "default": null,
      "title": "Groupkey",
      "type": "string",
      "nullable": true
    },
    "groupTypeIndex": {
      "default": null,
      "title": "Grouptypeindex",
      "type": "integer",
      "nullable": true
    },
    "kind": {
      "default": "TracesQuery",
      "title": "Kind",
      "type": "string",
      "enum": [
        "TracesQuery"
      ]
    },
    "limit": {
      "default": null,
      "title": "Limit",
      "type": "integer",
      "nullable": true
    },
    "modifiers": {
      "default": null,
      "description": "Modifiers used when performing the query",
      "allOf": [
        {
          "$ref": "#/components/schemas/HogQLQueryModifiers"
        }
      ],
      "nullable": true
    },
    "offset": {
      "default": null,
      "title": "Offset",
      "type": "integer",
      "nullable": true
    },
    "personId": {
      "default": null,
      "description": "Person who performed the event",
      "title": "Personid",
      "type": "string",
      "nullable": true
    },
    "properties": {
      "default": null,
      "description": "Properties configurable in the interface",
      "title": "Properties",
      "items": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/EventPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/PersonPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/ElementPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/EventMetadataPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/SessionPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/CohortPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/RecordingPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/LogEntryPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/GroupPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/FeaturePropertyFilter"
          },
          {
            "$ref": "#/components/schemas/FlagPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/HogQLPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/EmptyPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/DataWarehousePropertyFilter"
          },
          {
            "$ref": "#/components/schemas/DataWarehousePersonPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/ErrorTrackingIssueFilter"
          },
          {
            "$ref": "#/components/schemas/LogPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/SpanPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/RevenueAnalyticsPropertyFilter"
          },
          {
            "$ref": "#/components/schemas/WorkflowVariablePropertyFilter"
          }
        ]
      },
      "type": "array",
      "nullable": true
    },
    "randomOrder": {
      "default": null,
      "description": "Use random ordering instead of timestamp DESC. Useful for representative sampling to avoid recency bias.",
      "title": "Randomorder",
      "type": "boolean",
      "nullable": true
    },
    "response": {
      "default": null,
      "allOf": [
        {
          "$ref": "#/components/schemas/TracesQueryResponse"
        }
      ],
      "nullable": true
    },
    "showColumnConfigurator": {
      "default": null,
      "title": "Showcolumnconfigurator",
      "type": "boolean",
      "nullable": true
    },
    "tags": {
      "default": null,
      "allOf": [
        {
          "$ref": "#/components/schemas/QueryLogTags"
        }
      ],
      "nullable": true
    },
    "version": {
      "default": null,
      "description": "version of the node, used for schema migrations",
      "title": "Version",
      "type": "number",
      "nullable": true
    }
  },
  "type": "object"
}