{"command":{"effect":"read","timeoutSeconds":120,"inputSchema":{"type":"object","description":"Get completions usage details for the organization.","properties":{"query":{"type":"object","properties":{"start_time":{"type":"integer","description":"Start time (Unix seconds) of the query time range, inclusive."},"end_time":{"type":"integer","description":"End time (Unix seconds) of the query time range, exclusive."},"bucket_width":{"type":"string","enum":["1m","1h","1d"],"default":"1d","description":"Width of each time bucket in response. Currently `1m`, `1h` and `1d` are supported, default to `1d`."},"project_ids":{"type":"array","items":{"type":"string"},"description":"Return only usage for these projects."},"user_ids":{"type":"array","items":{"type":"string"},"description":"Return only usage for these users."},"api_key_ids":{"type":"array","items":{"type":"string"},"description":"Return only usage for these API keys."},"models":{"type":"array","items":{"type":"string"},"description":"Return only usage for these models."},"batch":{"type":"boolean","description":"If `true`, return batch jobs only. If `false`, return non-batch jobs only. By default, return both.\n"},"group_by":{"type":"array","items":{"type":"string","enum":["project_id","user_id","api_key_id","model","batch","service_tier","api_source"]},"description":"Group the usage data by the specified fields. Support fields include `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier`, `api_source` or any combination of them. When grouped by `api_source`, results use `agents_api` for attributed Agents API activity and `unlabeled` for all other activity. Without source grouping, `api_source` is null."},"limit":{"type":"integer","description":"Specifies the number of buckets to return.\n- `bucket_width=1d`: default: 7, max: 31\n- `bucket_width=1h`: default: 24, max: 168\n- `bucket_width=1m`: default: 60, max: 1440\n"},"page":{"type":"string","description":"A cursor for use in pagination. Corresponding to the `next_page` field from the previous response."}},"required":["start_time"],"additionalProperties":false}},"required":["query"],"additionalProperties":false},"name":"Completions","id":"openai.usage-completions","example":{"query":{"start_time":1}},"maxRequests":1,"summary":false}}