API reference Resources
Usage
Usage the fleet observed.
1 operation
Which AI services this workspace is actually using
GET/usage
Built from metadata alone, so it needs no content capture. Every row says whether an enabled catalog entry covers the service; the catalogued: false rows are the workspace's Shadow AI.
Query parameters
daysinteger
How far back to look. Defaults to 7 days.
Response200
Service usage in this workspace
servicesServiceUsage[]required
catalog_service_idstring · nullrequired
That row's service_id — service itself, or the row whose pattern covers the host. null when uncatalogued.
cataloguedbooleanrequired
Whether an enabled catalog row covers service.
first_seen_atstringrequired
The earliest observation in the window.
last_seen_atstringrequired
machinesintegerrequired
observationsintegerrequired
Errors
- 401
No valid session
- 403
Caller lacks machines:read in this workspace
- 404
No such workspace, or the caller is not a member