Move tool calls on GPT-6 Astra and GPT-6.1 Sol to the Responses API first, because those models call tools only there. Decide where conversation state lives and what OpenAI stores before you migrate. Chat Completions stays supported; the Assistants API shut down on August 26, 2026.
When you need this
- You are moving to GPT-6 models and use tool calling.
- Code still targets the retired Assistants API or reusable prompt objects.
- You are choosing between the Responses API, the Agents SDK, and the hosted Agents API for a new agent.
Evaluation criteria
Model support
Do the models you need support your current API for the features you use?
Look forGPT-6 Astra and GPT-6.1 Sol support Chat Completions, and they call tools only through Responses. GPT-6 Sol and GPT-6 Luna support function calling in Chat Completions only with reasoning effort set to none.
Parameters
Which request parameters change?
Look forReplace messages with input and move response_format to text.format. With reasoning effort above none, remove temperature, top_p, and logprobs. On GPT-6, replace prompt_cache_retention with prompt_cache_options.ttl.
State and storage
Where will conversation state live?
Look forOpenAI stores responses by default, so set store to false if you keep history yourself. Assistants moved to the Responses and Conversations APIs. Conversations keep state until you delete it, and Zero Data Retention does not cover them.
Runtime
Which runtime fits the agent?
Look forUse Responses when your application controls the loop. The Agents SDK adds handoffs and tracing in your runtime. The beta Agents API runs Codex's agent loop as a service OpenAI manages. Since October 9, 2026, its hosted sandboxes bill compute only during active turns. They can be pre-warmed and support computer use in an OpenAI-hosted browser. One builder moved every project to the SDK, while another moved a client to a different framework.
Caching and cost
Will the migration change your cache hit rate?
Look forOpenAI reports that Responses makes 40% to 80% better use of the cache than Chat Completions in its internal tests. Confirm it on your own traffic, and keep tool lists and tool_choice stable so the prefix does not change.
Effort and timing
How much of your code depends on vendor-managed state?
Look forMigration work sized from your existing state and retrieval code. A retrieval-augmented generation (RAG) chat team serving tens of thousands of users moved from Assistants to Responses in about two hours. One builder moved an Assistants MVP with little work. A team with its own history and retrieval found the port substantial. Another developer moved client work from Chat Completions to Responses for reasoning models.
Questions to ask vendors
- Which of our calls use tools on GPT-6 Astra or GPT-6.1 Sol and must move first?
- Do we keep conversation history ourselves, or rely on stored responses and Conversations?
- Which deprecated objects, such as reusable prompts shutting down on November 30, 2026, do we still call?
Red flags
- Leaving store at its default after moving from a stateless Chat Completions integration.
- Moving to GPT-6 tool calling on Chat Completions and expecting it to work.
- Rebuilding on a stateful API without planning how to leave it.
Products in this piece
Sources
- Official documentation
- 9
- Public source
- 6
- OpenAI API docs: Migrate to the Responses API
- OpenAI API docs: Using GPT-6
- OpenAI API docs: Assistants migration guide
- OpenAI API docs: Deprecations
- OpenAI API docs: Agents
- OpenAI API docs: Agents SDK
- OpenAI API docs: Agents API
- OpenAI API docs: Changelog
- OpenAI API docs: Data controls in the OpenAI platform
- Hacker News comment on migrating an MVP from Assistants to Responses (May 21, 2025)
- Hacker News comment on porting an assistant to the Responses API (Mar 12, 2025)
- Hacker News comment on using only Chat Completions with structured outputs (Mar 11, 2025)
- Hacker News comment on moving client work to the Responses API (Oct 2, 2026)
- Hacker News comment on moving projects to the Agents SDK (May 29, 2026)
- OpenAI Developer Forum: Switching a production app from the Assistants API to the Responses API (Mar 22, 2025)