Get Messages Usage Report changedapi/beta/organization/usage_report/retrieve_messages
Nearest release: v2.1.287, published 4 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+7added
Lines−5removed
From line
38
where the diff opens
First seen
10 Sep 2026
this site's first read of the page
Recorded edits6to this page, all time
The whole hunk
from line 38, old and new numbered
/
from line 38
3838
3939 - `"1m"`
4040
41- `context_window: optional array of "0-200k" or "200k-1M"`
41- `context_window: optional array of BetaAnalyticsContextWindow`
4242
4343 Restrict usage returned to the specified context window(s).
4444
from line 74
7474
7575 - `"workspace_id"`
7676
77- `inference_geos: optional array of "global" or "not_available" or "us"`
77- `inference_geos: optional array of BetaAnalyticsInferenceGeoFilter`
7878
7979 Restrict usage returned to the specified inference geo(s). Use `not_available` for models that do not support specifying `inference_geo`.
8080
from line 240
240240
241241 - `"ce-plugins-2026-09-01"`
242242
243 - `"spend-limit-reads-2026-09-26"`
244
243245## Returns
244246
245247- `BetaMessagesUsageReport object`
from line 288
286288
287289 The number of input tokens read from the cache.
288290
289 - `context_window: "0-200k" or "200k-1M" or null`
291 - `context_window: BetaAnalyticsContextWindow or null`
290292
291293 Context window used. `null` if not grouping by context window.
292294
from line 296
294296
295297 - `"200k-1M"`
296298
297 - `inference_geo: "global" or "not_available" or "us" or null`
299 - `inference_geo: BetaAnalyticsInferenceGeoFilter or null`
298300
299301 Inference geo used matching requests' `inference_geo` parameter if set, otherwise the workspace's `default_inference_geo`.
300302 For models that do not support specifying `inference_geo` the value is `"not_available"`. Always `null` if not grouping by inference geo.
from line 315
313315
314316 The number of output tokens generated.
315317
316 - `server_tool_use: object`
318 - `server_tool_use: BetaAnalyticsServerToolUse`
317319
318320 Server-side tool usage metrics.
319321
No line in this hunk matches that.