Follow Discord
Sweep 02 Oct 2026 · 18:55Z Build v2.1.288 509 read Stable v2.1.285 Latest v2.1.288 Next v2.1.288 Feeds RSS JSON llms.txt llms-full.txt Unofficial
One change · api

Usage Report changedapi/beta/organization/usage_report

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+10added
Lines−8removed
From line 40 where the diff opens
First seen 10 Sep 2026 this site's first read of the page
Recorded edits8to this page, all time

The whole hunk

from line 40, old and new numbered
/
lines
from line 40
4040 
4141 - `"1m"`
4242 
43- `context_window: optional array of "0-200k" or "200k-1M"`
43- `context_window: optional array of BetaAnalyticsContextWindow`
4444 
4545 Restrict usage returned to the specified context window(s).
4646 
from line 76
7676 
7777 - `"workspace_id"`
7878 
79- `inference_geos: optional array of "global" or "not_available" or "us"`
79- `inference_geos: optional array of BetaAnalyticsInferenceGeoFilter`
8080 
8181 Restrict usage returned to the specified inference geo(s). Use `not_available` for models that do not support specifying `inference_geo`.
8282 
from line 242
242242 
243243 - `"ce-plugins-2026-09-01"`
244244 
245 - `"spend-limit-reads-2026-09-26"`
246 
245247### Returns
246248 
247249- `BetaMessagesUsageReport object`
from line 290
288290 
289291 The number of input tokens read from the cache.
290292 
291 - `context_window: "0-200k" or "200k-1M" or null`
293 - `context_window: BetaAnalyticsContextWindow or null`
292294 
293295 Context window used. `null` if not grouping by context window.
294296 
from line 298
296298 
297299 - `"200k-1M"`
298300 
299 - `inference_geo: "global" or "not_available" or "us" or null`
301 - `inference_geo: BetaAnalyticsInferenceGeoFilter or null`
300302 
301303 Inference geo used matching requests' `inference_geo` parameter if set, otherwise the workspace's `default_inference_geo`.
302304 For models that do not support specifying `inference_geo` the value is `"not_available"`. Always `null` if not grouping by inference geo.
from line 317
315317 
316318 The number of output tokens generated.
317319 
318 - `server_tool_use: object`
320 - `server_tool_use: BetaAnalyticsServerToolUse`
319321 
320322 Server-side tool usage metrics.
321323 
from line 883
881883 
882884 The number of input tokens read from the cache.
883885 
884 - `context_window: "0-200k" or "200k-1M" or null`
886 - `context_window: BetaAnalyticsContextWindow or null`
885887 
886888 Context window used. `null` if not grouping by context window.
887889 
from line 891
889891 
890892 - `"200k-1M"`
891893 
892 - `inference_geo: "global" or "not_available" or "us" or null`
894 - `inference_geo: BetaAnalyticsInferenceGeoFilter or null`
893895 
894896 Inference geo used matching requests' `inference_geo` parameter if set, otherwise the workspace's `default_inference_geo`.
895897 For models that do not support specifying `inference_geo` the value is `"not_available"`. Always `null` if not grouping by inference geo.
from line 910
908910 
909911 The number of output tokens generated.
910912 
911 - `server_tool_use: object`
913 - `server_tool_use: BetaAnalyticsServerToolUse`
912914 
913915 Server-side tool usage metrics.
914916 
Feedback