openai · OpenAI Platform Docs
Assistants migration guide | OpenAI API
Provides a step-by-step workflow for transitioning existing implementations to the Assistants API, including handling changes in object structures and API endpoints.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Assistants migration guide | OpenAI API
Provides a step-by-step workflow for transitioning existing implementations to the Assistants API, including handling changes in object structures and API endpoints.
When To Use
Use when migrating existing OpenAI API implementations to the Assistants API or updating legacy code to comply with new Assistants API structures.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/assistants-migration-guide-openai-api-workflow-guide.md | A guide detailing the transition from the deprecated Assistants API to the Responses API, including key changes and practical migration steps. | Questions about a guide detailing the transition from the deprecated Assistants API to the Responses API, including key changes and p... |
examples/assistants-migration-guide-openai-api-python-thread-creation.text | A Python code snippet demonstrating how to create a thread with messages and metadata as part of the Assistants API migration. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to create a thread with messages and metadata as part of the Assistants API m... |
examples/assistants-migration-guide-openai-api-conversation-create.text | A text example demonstrating the openai-conversations-create method with user items and metadata as part of the Assistants migration guide. | Exact payloads, commands, or snippets shown in A text example demonstrating the openai-conversations-create method with user items and metadata as part of the Assis... |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-thread.text | A text representation of a migrated thread object containing metadata and tool resources. | Exact payloads, commands, or snippets shown in A text representation of a migrated thread object containing metadata and tool resources. |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-conver.text | A text representation of a conversation object used during the Assistants API migration process. | Exact payloads, commands, or snippets shown in A text representation of a conversation object used during the Assistants API migration process. |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-python.text | A Python code snippet demonstrating how to create and poll a thread run during the Assistants API migration process. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to create and poll a thread run during the Assistants API migration process. |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-guide.text | A text-based example illustrating the structural differences and migration steps between legacy and current Assistants API implementations. | Exact payloads, commands, or snippets shown in A text-based example illustrating the structural differences and migration steps between legacy and current Assistant... |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-run-ob.text | A text representation of an OpenAI Assistants API run object showing migration-relevant fields like assistant ID and completion timestamps. | Exact payloads, commands, or snippets shown in A text representation of an OpenAI Assistants API run object showing migration-relevant fields like assistant ID and... |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-guide-2.text | A text-based guide outlining the steps and considerations for migrating to the OpenAI Assistants API. | Exact payloads, commands, or snippets shown in A text-based guide outlining the steps and considerations for migrating to the OpenAI Assistants API. |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-python-2.text | A Python code snippet demonstrating how to iterate through messages in a thread using the OpenAI Assistants API. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to iterate through messages in a thread using the OpenAI Assistants API. |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-python-3.text | A Python code example demonstrating the implementation of the Assistants API using threads, messages, and runs. | Exact payloads, commands, or snippets shown in A Python code example demonstrating the implementation of the Assistants API using threads, messages, and runs. |
examples/assistants-migration-guide-openai-api-openai-assistants-migration-compar.text | A text-based comparison showing the structural differences between legacy conversation objects and the new Assistants API implementation. | Exact payloads, commands, or snippets shown in A text-based comparison showing the structural differences between legacy conversation objects and the new Assistants... |
What This Skill Covers
- After achieving feature parity in the Responses API, we've deprecated the Assistants API. It will shut down on August 26, 2026. Follow the migration guide to...
- Main sections:
What’s changed?,From assistants to prompts,Why this is helpful,Practical migration steps,From threads to conversations.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.openai.com/api/docs/guides/assistants/migration