Away 10:09 PM

2 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

AnalyticsQueryPublicApi.DimensionValuesRequest — openapi

A request to query dimension values.

Properties

NameTypeRequiredDescription
metricstringtrueThe metric that provides context for resolving dimension namespaces.
dimensionsarrayfalseThe dimensions to retrieve values for. Each entry is a single dimension name.
startTimestringtrueThe inclusive start of the query time range. Any UTC offset is accepted; results are always bucketed in UTC.
endTimestringtrueThe exclusive end of the query time range. Any UTC offset is accepted; results are always bucketed in UTC.
filterarrayfalseFilters to apply to the query.
granularity#/components/schemas/AnalyticsQueryPublicApi.MetricGranularityfalse
limitintegerfalseThe maximum number of values to return per dimension.

Complete Schema

{
  "required": [
    "endTime",
    "metric",
    "startTime"
  ],
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "description": "The metric that provides context for resolving dimension namespaces."
    },
    "dimensions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The dimensions to retrieve values for. Each entry is a single dimension name."
    },
    "startTime": {
      "type": "string",
      "description": "The inclusive start of the query time range. Any UTC offset is accepted; results are always bucketed in UTC.",
      "format": "date-time"
    },
    "endTime": {
      "type": "string",
      "description": "The exclusive end of the query time range. Any UTC offset is accepted; results are always bucketed in UTC.",
      "format": "date-time"
    },
    "filter": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/AnalyticsQueryPublicApi.QueryFilter"
      },
      "description": "Filters to apply to the query."
    },
    "granularity": {
      "$ref": "#/components/schemas/AnalyticsQueryPublicApi.MetricGranularity"
    },
    "limit": {
      "type": "integer",
      "description": "The maximum number of values to return per dimension.",
      "format": "int32"
    }
  },
  "additionalProperties": false,
  "description": "A request to query dimension values."
}