Info
Endpoint added: GET /organization/usage/decisions
openapi:GET /organization/usage/decisions::operation.endpoint-added- Product
- OpenAI API
- Source
- OpenAPI URL
- Change kind
- Endpoint Added
- Detected
- Last updated
Deterministic evidence
Before / after
Extracted from OpenAI's published contract. Shows the whole operation — a narrower excerpt was not available for this change. Open the source ↗
null
{
"operationId": "OrganizationDecisionsusage",
"parameters": [
{
"in": "query",
"name": "start_time",
"required": true,
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "end_time",
"schema": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "bucket_width",
"schema": {
"anyOf": [
{
"oneOf": [
{
"enum": [
"1m",
"1h",
"1d"
],
"type": "string"
}
]
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "limit",
"schema": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "page",
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "project_ids",
"schema": {
"anyOf": [
{
"oneOf": [
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "group_by",
"schema": {
"anyOf": [
{
"oneOf": [
{
"items": {
"enum": [
"project_id",
"user_id",
"api_key_id",
"model",
"batch",
"service_tier",
"api_source"
],
"type": "string"
},
"type": "array"
}
]
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "user_ids",
"schema": {
"anyOf": [
{
"oneOf": [
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "api_key_ids",
"schema": {
"anyOf": [
{
"oneOf": [
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "models",
"schema": {
"anyOf": [
{
"oneOf": [
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
{
"type": "null"
}
]
}
},
{
"in": "query",
"name": "batch",
"schema": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"data": {
"items": {
"properties": {
"end_time": {
"type": "integer"
},
"object": {
"default": "bucket",
"enum": [
"bucket"
],
"type": "string",
"x-stainless-const": true
},
"results": {
"items": {
"properties": {
"api_key_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"api_source": {
"anyOf": [
{
"enum": [
"agents_api",
"unlabeled"
],
"type": "string"
},
{
"type": "null"
}
]
},
"batch": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"input_audio_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_cache_write_12h_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_cache_write_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_cached_audio_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_cached_image_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_cached_text_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_cached_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_image_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_text_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"input_tokens": {
"type": "integer"
},
"input_uncached_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"num_model_requests": {
"type": "integer"
},
"object": {
"default": "organization.usage.decisions.result",
"enum": [
"organization.usage.decisions.result"
],
"type": "string",
"x-stainless-const": true
},
"output_audio_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"output_image_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"output_text_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"output_tokens": {
"type": "integer"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"service_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"object",
"input_tokens",
"output_tokens",
"num_model_requests"
],
"type": "object"
},
"type": "array"
},
"start_time": {
"type": "integer"
}
},
"required": [
"object",
"start_time",
"end_time",
"results"
],
"type": "object"
},
"type": "array"
},
"has_more": {
"type": "boolean"
},
"next_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"object": {
"default": "page",
"enum": [
"page"
],
"type": "string",
"x-stainless-const": true
}
},
"required": [
"object",
"has_more",
"next_page",
"data"
],
"type": "object"
}
}
}
},
"400": {
"content": {
"application/json": {
"schema": {
"properties": {
"error": {
"$ref": "#/components/schemas/DecisionsUsageErrorDetails"
}
},
"required": [
"error"
],
"type": "object"
}
}
}
},
"403": {
"content": {
"application/json": {
"schema": {
"properties": {
"error": {
"oneOf": [
{
"$ref": "#/components/schemas/DecisionsUsageErrorDetails"
},
{
"type": "string"
}
]
}
},
"required": [
"error"
],
"type": "object"
}
}
}
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
}
},
"security": [
{
"AdminApiKeyAuth": []
}
],
"x-oaiMeta": {
"group": "usage-decisions"
}
}
Monitored for you
Does this change affect your integration?
Choose the operations and fields your services use. Detektu matches OpenAI findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.