Events & ExportExport semantic catalog

Export semantic catalog

The export's semantic catalog — the single source of truth for building an insight/breakdown picker. Static and identical for every caller; no bound location required. Versioned and additive-only (columns and tables are only added, never renamed or removed without a version bump).

Per column: name, type, filterable, groupable, aggregatable, group (entity-only: event | person | session), label. Per table: source and shape (event = row-per-event; metric = row-per-period/entity).

This describes the export views only — not the hello-conversions insights catalog, whose column set differs.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/data/export/schema" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": {
    "version": "1.0.0",
    "stability": "additive-only",
    "partition_filter": {
      "events": "event_timestamp",
      "person_events": "event_timestamp",
      "sessions": "started_at"
    },
    "tables": [
      {
        "id": "events",
        "label": "Events",
        "source": "mythic-activity",
        "shape": "event",
        "freshness": "realtime",
        "columns": [
          {
            "name": "John Doe",
            "label": "example_string",
            "type": "example_string",
            "filterable": true,
            "groupable": true,
            "aggregatable": true,
            "group": "event"
          }
        ]
      }
    ]
  }
}
GET
/export/schema
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.

Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.

Responses

successboolean
dataobject