{"command":{"effect":"read","timeoutSeconds":120,"inputSchema":{"type":"object","description":"Get costs 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":["1d"],"default":"1d","description":"Width of each time bucket in response. Currently only `1d` is supported, default to `1d`."},"project_ids":{"type":"array","items":{"type":"string"},"description":"Return only costs for these projects."},"api_key_ids":{"type":"array","items":{"type":"string"},"description":"Return only costs for these API keys."},"line_items":{"type":"array","items":{"type":"string"},"description":"Return only costs for these exact line item names. Each value must match the complete `line_item` value, for example `gpt-6-astra, input_tokens`."},"group_by":{"type":"array","items":{"type":"string","enum":["project_id","user_id","line_item","api_key_id","api_source"]},"description":"Group the costs by the specified fields. Supported fields include `project_id`, `user_id`, `line_item`, `api_key_id`, and `api_source`. Support for combining `user_id` with `project_id` grouping or the `project_ids` filter depends on the organization and requested time range. Unsupported combinations return HTTP 400. 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","default":7,"description":"A limit on the number of buckets to be returned. Limit can range between 1 and 180, and the default is 7.\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":"Costs","id":"openai.usage-costs","example":{"query":{"start_time":1}},"maxRequests":1,"summary":false}}