As of March 11, 2025, we’ve released the building blocks of our new Agents platform. For details, see our API docs for our Responses API, Tools including Web Search, File Search, and Computer Use, and our Agents SDK with Tracing.
No Automatic Upgrade: Your current Assistants, Threads, and Runs are not automatically migrated to v2. They remain accessible and operational under the v1 API unless you choose to migrate them manually.
Access to Both Versions: Both v1 and v2 API versions are fully accessible to you. This means you can continue using v1 for your existing assistants or explore the new features and improvements offered by v2.
Token Usage Differences: There may be variations in token usage between v1 and v2, particularly tools like file_search and retrieval. While the file_search tool in v2 typically consumes fewer tokens on average compared to the retrieval tool in v1, you can still use the older retrieval tool with the v1 version header if you'd like.
Migration Options: Playground UI and updated SDK versions use the v2 version of the API, and Assistants API requests must include the OpenAI-Beta: assistants=v2 header. Assistants API v1 is deprecated; any remaining v1 integrations should migrate to v2. For more information regarding migration from Assistants v1 to v2, please check out this migration guide.