Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
field | str | :heavy_check_mark: | Dimension to filter on. Use the /meta endpoint for available dimensions. | model |
operator | str | :heavy_check_mark: | Filter operator | eq |
value | operations.Value1 | :heavy_check_mark: | Filter value (scalar or array depending on operator). Several dimensions are enriched in responses (returned as human-readable labels), but filters must use the underlying ID: api_key_id — numeric ID (from generation metadata) or key hash (64-char hex from GET /api/v1/keys, resolved server-side); user — Clerk user ID (e.g. “user_abc123”), not the display name; workspace — workspace UUID, not the workspace name (filtering or grouping by the account default workspace also covers activity recorded before workspace resolution existed, which is attributed to that default workspace); app — numeric app ID, not the app title; model — permaslug (e.g. “openai/gpt-4o”), not the display name. Other dimensions (provider, origin, country, etc.) are not enriched and accept the value as returned. |