list_usage_dimensions
List the distinct values seen for a usage dimension ("metric" or "external_customer_id") over a date range — useful for discovering filter values before calling query_usage. Each entry pairs the raw value with a label (for external_customer_id, the customer's name from account_customers when known, falling back to the id itself). Use "dimension_key" to list the keys of the pushed dimensions map; BigQuery job usage uses user_email (the user who ran the job), region, project_id, dts_config_id and query_hash. Mirrors GET /api/usage/dimensions.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dimension": "<dimension>"
},
"name": "list_usage_dimensions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | No | ||
| dimension | Yes | "metric", "external_customer_id", "dimension_key" (the keys of the pushed dimensions map) or "dimension:<key>" (that key's values) | |
| start_date | No |