Queries

threadTimeSeriesMetric

Fetch a time-series metric for threads with rich filter and group-by support. Choose a TimeSeriesMetricName (e.g. threads_created_count, threads_first_response_time__p50), specify a mandatory date range and bucketing interval, and optionally group results by assignee, company, tier, label type, and more. This is the preferred reporting query when you need server-side filtering across thread attributes. Requires metrics:read; grouping by assignee or filtering assignedToUser to anyone other than the caller additionally requires metricsAgent:read.

QUERY

threadTimeSeriesMetric(input: ThreadTimeSeriesMetricInput!): ThreadTimeSeriesMetric!

Arguments

input

ThreadTimeSeriesMetricInput!

required

Returns

ThreadTimeSeriesMetric!

timestamps

[DateTime!]

Ordered bucket start times for the series data points, one per interval. Null in threadIds mode.

series

[ThreadTimeSeriesSeries!]

One series entry per group bucket (or a single entry when no group-by is requested). Null in threadIds mode.

threadIds

[ID!]

The distinct thread ids behind the slice. Populated only when mode is threadIds; null otherwise.

Query

query ThreadTimeSeriesMetric($input: ThreadTimeSeriesMetricInput!) {
  threadTimeSeriesMetric(input: $input) {
    timestamps {
      unixTimestamp
      iso8601
    }
    series {
      values
      group {
        dimension
        value
        label
      }
    }
    threadIds
  }
}

Variables

{
  "input": {
    "metricName": "threads_created_count",
    "from": "string",
    "to": "string",
    "interval": {
      "unit": "HOUR"
    },
    "mode": "METRIC"
  }
}

Response

{
  "data": {
    "threadTimeSeriesMetric": {
      "timestamps": [
        {
          "unixTimestamp": "string",
          "iso8601": "string"
        }
      ],
      "series": [
        {
          "values": [
            1.5
          ],
          "group": {
            "dimension": "ASSIGNEE",
            "value": "string",
            "label": "string"
          }
        }
      ],
      "threadIds": [
        "id"
      ]
    }
  }
}

⌘I