API Changelog

​

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