Skip to main content

Search workspace measured usage

Search delayed measured spend. Principal filters select the scope; there is no target. With no user_id or agent_id filter, the scope is the organization. A single-value EQUALS user_id filter reads that user's measured events. A single-value EQUALS agent_id filter, with no user_id filter, reads that top-level agent. Any other principal filter reads the organization, then narrows rows. Requires admin.usage:read and workspace billing read permission; an administrator role alone is not sufficient. USER_ID grouping is supported; DEPARTMENT_NAME and GROUP_ID are deferred and return invalid_parameter. The calculation and response are shared with personal search. Labels remain subject to current resource visibility, not billing access. Historical agent attribution is never reparented at query time. AGENT uses app-compatible best-effort recorded top-agent/root attribution and same-run AGENT/LLM_CALL events, not complete run lineage. Totals describe the observed stored snapshot, not certified billing history. Usage billed in GCU on full-consumption plans isn't reported yet and is excluded from results and totals. A month whose source rows exceed 200,000 at the day and user detail the query needs, or whose source read exceeds its size, billed-byte or 30-second limit, returns 422 unprocessable_query; use a coarser granularity, fewer dimensions, or a shorter range. Organization and agent reads return 503 while the directory loads. In workspaces with more than 100,000 directory identities, reads that group or filter by user return 503.

Request​

Responses​

Measured usage buckets and complete-query totals.