API Changelog

​

Breaking changes

• FusionCallAnalysisInProgressEvent — required analyst_model property added
  • No action required for existing consumers. analyst_model replaces judge_model in this streaming event; judge_model is retained as a deprecated alias that always carries the same value.
  • Used by POST /responses
• $.tags: responses object removed
  • No action required. The responses OpenAPI tag was renamed to Responses for consistent Title Case across the API Reference. This is a documentation-grouping change only: POST /api/v1/responses and its schemas are unchanged, SDK namespaces are unchanged (client.responses.send() in TypeScript and Python, Sdk.Responses.Send() in Go), and endpoint documentation URLs are unchanged.

​

Modified endpoints

• GET /files — parameter cursor updated; response schema updated
• POST /files — response schema updated
• DELETE /files/{file_id} — parameter file_id updated; response schema updated
• GET /files/{file_id} — parameter file_id updated; response schema updated
• GET /files/{file_id}/content — parameter file_id updated

​

Modified schemas

• FusionAnalysisResult — description updated
  • Used by POST /presets/{slug}/responses, POST /responses
• FusionCallAnalysisCompletedEvent — description updated
  • Used by POST /responses
• FusionCallAnalysisInProgressEvent:
  • description updated
  • example modified
  • new property analyst_model
  • property judge_model deprecated (alias of analyst_model, kept for existing consumers)
  • Used by POST /responses
• FusionPlugin — description updated

  Show 6 endpoints using this schema

  • POST /chat/completions
  • POST /messages
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/messages
  • POST /presets/{slug}/responses
  • POST /responses
• FusionServerToolConfig — description updated; property effort updated; property max_tokens updated

  Show 4 endpoints using this schema

  • POST /chat/completions
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/responses
  • POST /responses
• FusionServerTool_OpenRouter — description updated

  Show 4 endpoints using this schema

  • POST /chat/completions
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/responses
  • POST /responses
• FusionSource — description updated
  • Used by POST /presets/{slug}/responses, POST /responses
• OutputFusionServerToolItem — description updated
  • Used by POST /presets/{slug}/responses, POST /responses
• ChatWebSearchShorthand — description updated
  • Used by POST /chat/completions, POST /presets/{slug}/chat/completions
• WebSearchConfig — description updated

  Show 4 endpoints using this schema

  • POST /chat/completions
  • POST /messages
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/messages
• WebSearchDomainFilter — example modified; new property blocked_domains
  • Used by POST /presets/{slug}/responses, POST /responses
• WebSearchServerToolConfig — description updated
  • Used by POST /presets/{slug}/responses, POST /responses
• AnthropicFileDocumentSource — example modified
  • Used by POST /messages, POST /presets/{slug}/messages
• FileDeleteResponse — example modified
  • Used by DELETE /files/{file_id}
• FileListResponse — example modified
  • Used by GET /files
• FileMetadata — example modified
  • Used by GET /files, GET /files/{file_id}, POST /files
• GenerationResponse — property data_region updated
  • Used by GET /generation
• CreateGuardrailRequest — new property enable_free_model_publication; new property enable_free_model_training; new property enable_paid_model_training
  • Used by POST /guardrails
• Guardrail:
  • example modified
  • new property enable_free_model_publication
  • new property enable_free_model_training
  • new property enable_paid_model_training

  Show 4 endpoints using this schema

  • GET /guardrails
  • GET /guardrails/{id}
  • PATCH /guardrails/{id}
  • POST /guardrails
• UpdateGuardrailRequest — new property enable_free_model_publication; new property enable_free_model_training; new property enable_paid_model_training
  • Used by PATCH /guardrails/{id}
• AutoBetaRouterPlugin:
  • example modified
  • new property cost_tier
  • deprecated property_added
  • description updated

  Show 6 endpoints using this schema

  • POST /chat/completions
  • POST /messages
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/messages
  • POST /presets/{slug}/responses
  • POST /responses
• AutoRouterPlugin:
  • example modified
  • new property cost_tier
  • deprecated property_added
  • description updated

  Show 6 endpoints using this schema

  • POST /chat/completions
  • POST /messages
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/messages
  • POST /presets/{slug}/responses
  • POST /responses

​

Modified endpoints

• POST /embeddings — request schema updated

​

Modified schemas

• Quantization — enum property_added

  Show 10 endpoints using this schema

  • GET /endpoints/zdr
  • GET /models/{author}/{slug}/endpoints
  • POST /chat/completions
  • POST /embeddings
  • POST /messages
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/messages
  • POST /presets/{slug}/responses
  • POST /rerank
  • POST /responses
• ReasoningFormat — enum property_added

  Show 4 endpoints using this schema

  • POST /chat/completions
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/responses
  • POST /responses

​

Breaking changes

• POST /responses — tags beta.responses property removed
  • Migration: no action for HTTP clients. The Responses API is now GA. beta.responses was an OpenAPI grouping tag and SDK namespace, never a URL — POST /api/v1/responses and its request and response schemas are unchanged, so raw HTTP callers and OpenAI-compatible clients (including the OpenAI Agents SDK) need no changes. The endpoint now appears under Responses instead of Beta responses in the API Reference.
  • Migration for SDK users: optional until sunset. The canonical namespace is now responses — client.responses.send() (TypeScript, Python) and client.Responses.Send() (Go). The beta.responses namespace, and TypeScript’s betaResponsesSend standalone function, keep working as deprecated aliases; their removal will be announced here with a sunset date before it ships.
• $.tags: beta.responses object removed
  • Same change as above at the specification level: the beta.responses tag definition is gone from $.tags.

​

Modified endpoints

• POST /responses — tags property_added
• GET /byok — parameter provider updated

​

Modified schemas

• MessagesStartEvent — property provider updated
  • Used by POST /messages
• ProviderName — enum property_added

  Show 11 endpoints using this schema

  • GET /endpoints/zdr
  • GET /models/{author}/{slug}/endpoints
  • POST /chat/completions
  • POST /embeddings
  • POST /images
  • POST /messages
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/messages
  • POST /presets/{slug}/responses
  • POST /rerank
  • POST /responses
• ProviderOptions — new property claude-on-aws

  Show 4 endpoints using this schema

  • POST /audio/speech
  • POST /audio/transcriptions
  • POST /images
  • POST /videos
• ProviderResponse — enum property_added
  • Used by GET /generation
• BYOKProviderSlug — enum property_added

  Show 4 endpoints using this schema

  • GET /byok
  • GET /byok/{id}
  • PATCH /byok/{id}
  • POST /byok

​

Modified schemas

• MessagesStartEvent — property provider updated
  • Used by POST /messages
• ProviderName — enum property_added

  Show 11 endpoints using this schema

  • GET /endpoints/zdr
  • GET /models/{author}/{slug}/endpoints
  • POST /chat/completions
  • POST /embeddings
  • POST /images
  • POST /messages
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/messages
  • POST /presets/{slug}/responses
  • POST /rerank
  • POST /responses
• ProviderOptions — new property voyageai

  Show 4 endpoints using this schema

  • POST /audio/speech
  • POST /audio/transcriptions
  • POST /images
  • POST /videos
• ProviderResponse — enum property_added
  • Used by GET /generation
• AnthropicCompactionBlock — new property encrypted_content
  • Used by POST /messages
• MessagesToolAdditionBlock — new property cache_control; new union variant added; type property_removed
  • tool widened from a single tool_reference object to a union of tool_reference, mcp_tool_reference (name + server_name) and mcp_toolset_reference (server_name). The tool_reference variant is unchanged, so existing { "type": "tool_reference", "name": "…" } payloads stay valid — the name and type properties moved into that variant rather than being removed.
  • Used by POST /messages, POST /presets/{slug}/messages
• MessagesToolRemovalBlock — new property cache_control; new union variant added; type property_removed
  • tool widened the same way as MessagesToolAdditionBlock; existing tool_reference payloads stay valid.
  • Used by POST /messages, POST /presets/{slug}/messages
• ORAnthropicStopReason — enum property_added
  • Used by POST /messages

​

New schemas

• ImageGenTextChunkEvent
  • Used by POST /images

​

Modified schemas

• ImageStreamingResponse — new union variant added
  • Used by POST /images

​

Modified endpoints

• POST /audio/transcriptions — description updated; request body now accepts multipart/form-data
• GET /datasets/rankings-daily:
  • description updated
  • new parameter category
  • new parameter context_bucket
  • new parameter language_type
  • new parameter modality
  • new parameter period
• GET /models:
  • new parameter max_age_days
  • new parameter max_agentic_index
  • new parameter max_coding_index
  • new parameter max_intelligence_index
  • new parameter max_output_price
  • new parameter max_tool_success_rate
  • new parameter min_age_days
  • new parameter min_agentic_index
  • new parameter min_coding_index
  • new parameter min_intelligence_index
  • new parameter min_output_price
  • new parameter min_tool_success_rate
  • description updated
  • parameter sort updated

​

New response codes

• POST /images — now returns 413

​

New schemas

• STTSegment
  • Used by POST /audio/transcriptions
• STTTimestampGranularity
  • Used by POST /audio/transcriptions
• STTWord
  • Used by POST /audio/transcriptions

​

Modified schemas

• ChatFunctionTool — new union variant added
  • Used by POST /chat/completions, POST /presets/{slug}/chat/completions
• FusionServerToolConfig — description updated

  Show 4 endpoints using this schema

  • POST /chat/completions
  • POST /presets/{slug}/chat/completions
  • POST /presets/{slug}/responses
  • POST /responses
• ImageGenCompletedEvent — description updated; example modified
  • Used by POST /images
• ImageGenerationResponse — property media_type updated
  • Used by POST /images
• STTRequest — new property response_format; new property timestamp_granularities
  • Used by POST /audio/transcriptions
• STTResponse:
  • new property duration
  • new property language
  • new property segments
  • new property task
  • new property words
  • Used by POST /audio/transcriptions

​

New endpoints

• GET /workspaces/{id}/members — List workspace members

​

New schemas

• ListWorkspaceMembersResponse
  • Used by GET /workspaces/{id}/members