{"command":{"effect":"read","timeoutSeconds":120,"inputSchema":{"type":"object","description":"Get Decisions API 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":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End time (Unix seconds) of the query time range, exclusive."},"bucket_width":{"anyOf":[{"description":"Width of each time bucket in response. Currently `1m`, `1h` and `1d` are supported, default to `1d`.","oneOf":[{"$ref":"#/definitions/DecisionsUsageBucketWidth"}]},{"type":"null"}],"description":"Width of each time bucket in response. Currently `1m`, `1h` and `1d` are supported, default to `1d`."},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"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"},"page":{"anyOf":[{"description":"A cursor for use in pagination. Corresponding to the `next_page` field from the previous response.","type":"string"},{"type":"null"}],"description":"A cursor for use in pagination. Corresponding to the `next_page` field from the previous response."},"project_ids":{"anyOf":[{"description":"Return only usage for these projects.","oneOf":[{"type":"array","items":{"type":"string"}}]},{"type":"null"}],"description":"Return only usage for these projects."},"group_by":{"anyOf":[{"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.","oneOf":[{"type":"array","items":{"$ref":"#/definitions/DecisionsUsageGroupBy"}}]},{"type":"null"}],"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."},"user_ids":{"anyOf":[{"description":"Return only usage for these users.","oneOf":[{"type":"array","items":{"type":"string"}}]},{"type":"null"}],"description":"Return only usage for these users."},"api_key_ids":{"anyOf":[{"description":"Return only usage for these API keys.","oneOf":[{"type":"array","items":{"type":"string"}}]},{"type":"null"}],"description":"Return only usage for these API keys."},"models":{"anyOf":[{"description":"Return only usage for these models.","oneOf":[{"type":"array","items":{"type":"string"}}]},{"type":"null"}],"description":"Return only usage for these models."},"batch":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"If `true`, return batch jobs only. If `false`, return non-batch jobs only. By default, return both."}},"required":["start_time"],"additionalProperties":false}},"required":["query"],"additionalProperties":false,"definitions":{"DecisionsUsageBucketWidth":{"type":"string","enum":["1m","1h","1d"]},"DecisionsUsageGroupBy":{"type":"string","enum":["project_id","user_id","api_key_id","model","batch","service_tier","api_source"]}}},"name":"Decisions","id":"openai.organizationdecisionsusage","example":{"query":{"start_time":1}},"maxRequests":1,"summary":false}}