OpenAI Assistants API: Retirement, migration, and alternatives

Kenneth Pangan
Written by

Kenneth Pangan

Katelin Teen
Reviewed by

Katelin Teen

Last edited September 8, 2026

Expert Verified
An illustration of AI assistant tools

The OpenAI Assistants API retired on August 26, 2026 and is no longer available. OpenAI’s migration guide directs developers to the Responses API. This is no longer a future deprecation to put on a roadmap: an application still relying on Assistants needs a supported implementation.

For a support team, there are two different decisions to make. One is how to migrate a custom application. The other is whether the job still needs a custom application at all. This guide covers the API changes first, then explains how eesel CLI can help operate a support teammate when that is the outcome you need.

What was the OpenAI Assistants API?

The Assistants API supplied persistent assistant configuration, stored conversation threads, and runs that processed those conversations. It also provided access to tools such as file search and Code Interpreter, alongside function calling for application-defined actions.

Its main objects separated configuration from conversation:

  • An Assistant held model choice, instructions, and tool declarations.
  • A Thread stored messages in a conversation.
  • A Run executed an assistant against a thread.
  • Run steps recorded parts of that execution.

That structure helped developers assemble AI assistants without inventing each component. It did not provide the whole support product: the application still needed a customer interface, identity checks, business-system connections, and rules about what the assistant could do.

What changes when migrating to Responses?

OpenAI’s migration documentation maps the old objects to a different set of concepts:

Assistants API conceptResponses-era conceptWhat to review
AssistantPrompt configurationModel, instructions, tools, and version selection
ThreadConversationStored items, user ownership, and retention
RunResponseInput and output handling, errors, and tool execution
Run stepItemMessages, function calls, and tool results

Treat this as a guide to responsibilities, not a find-and-replace list. Existing object IDs and application assumptions need review. Start with the assistant’s instructions and tool definitions, then check how the application creates a conversation and processes each response.

Conversation state is still supported

Responses does not force every application to rebuild conversation storage from scratch. You can use a persistent Conversation, chain responses with previous_response_id, or pass prior items yourself. The Responses migration guide explains the options.

The distinction matters when porting a support assistant. A follow-up such as “what if I bought it last month?” needs the relevant earlier question and answer. Check that the new implementation preserves that context without mixing conversations belonging to different customers.

When chaining calls, resend top-level instructions: previous_response_id does not carry those instructions forward. Stored context also does not mean free context. Earlier input tokens in a response chain are still billed as input tokens.

Tool execution needs a deliberate migration

Responses returns typed output items, which can include messages and function calls. An application-defined function still needs application code to execute it and return a result associated with the matching call_id. OpenAI-hosted tools can handle their own execution.

For example, a tool that changes an order address needs the same identity checks and action limits after migration as before it. Do not infer permission merely because a model requested the function. For more on that distinction, see function calling.

Also review streaming consumers and structured output parsing. Responses uses typed streaming events, and structured output configuration belongs under text.format. Reusing an old parser without checking its assumptions can leave a working request paired with a broken interface.

File search and cost: What to measure

File search retrieves information from uploaded files in a vector store through semantic and keyword search. OpenAI hosts the tool’s execution, so using it does not require you to implement every retrieval step yourself. The file search guide explains the setup.

It would be misleading to estimate every question as “the complete text of every uploaded PDF, charged again.” Measure the input actually used, generated output, tool activity, and storage. A document upload and a model’s selected context are different things.

For a migrated application, compare short questions, long conversations, retrieval-heavy requests, and failed tool calls. Check current API pricing for the models and tools you choose. Historical Assistants tool prices are not a current quote for a Responses deployment.

Run the support job through eesel CLI

If the old assistant mainly answered customer questions from company policies and helpdesk knowledge, consider whether you want to maintain a custom application for that job. eesel’s helpdesk teammate is a support-focused product, and eesel CLI lets you operate it from a terminal.

The CLI uses the same teammate and workspace as the dashboard. It is useful when a developer wants to configure the setup, a script needs to inspect it, or a coding agent such as Claude Code, Cursor, or Codex is helping with the work. The support team can still review that same setup in the dashboard.

Start with the existing workspace

With Node.js 18.17 or newer, use the npm package directly. For an existing account, log in before setting up anything new:

Bash
npx @eesel/cli login
npx @eesel/cli whoami
npx @eesel/cli agents

Choose the intended teammate from the agent list. Replace AGENT_ID below with its ID:

Bash
npx @eesel/cli integrations --agent AGENT_ID
npx @eesel/cli status --agent AGENT_ID
npx @eesel/cli instructions --agent AGENT_ID

These commands answer three separate questions: which systems are connected, whether connected content has downloaded, and what standing rules the teammate follows. A successful status check does not establish that the knowledge is correct or the answers meet your policy.

Bring the support knowledge, not the old API objects

Suppose your old assistant used an approved warranty policy. You can upload that source document:

Bash
npx @eesel/cli files upload ./warranty-policy.pdf --agent AGENT_ID

This adds knowledge to eesel. It does not import an OpenAI Assistant, its threads, or its vector store, and it does not update the teammate’s standing instructions.

Review the instructions separately: what can it answer, when should it ask for more information, and which cases need a person? If the job needs a helpdesk connection, the CLI also supports connecting integrations such as Zendesk and Freshdesk, with browser authorization where required.

Test representative questions on a test agent with suitable action restrictions. Compare answers with the original policy and inspect activity. CLI chat can invoke actions; it is not automatically a read-only test environment.

Give a coding agent a bounded setup task

JSON output lets a coding agent read command results. It can list the connections, inspect the result, and identify the next step. Errors include structured information and a hint about what to do next.

For example, ask it to inspect a specified agent’s sources and instructions, report missing configuration, and request permission before changing anything. That permission requirement comes from your instructions to the coding agent. It is distinct from eesel’s approvals command, which reviews actions held for the eesel teammate.

The CLI also exposes activity for recent work and automations for event, scheduled, and webhook automation settings. Use a command’s --help to inspect available operations. --dry-run prints the server call a write would make without sending it; it is not a simulation of the teammate’s answer.

For a headless script, configure EESEL_API_URL and EESEL_API_TOKEN, and scope it with EESEL_AGENT_ID or an explicit agent flag. Store credentials securely. OpenAI API keys, eesel credentials, and their billing are separate.

API migration or a support teammate?

Choose Responses when your product needs a custom application whose interface, tool logic, and runtime you own. Follow the migration guide, validate representative behavior, and check your app’s authentication, errors, and usage.

Evaluate eesel when the requirement is an operational support teammate connected to your knowledge and existing tools. The CLI gives technical users a way to configure and inspect that product without turning every task into a dashboard visit.

Neither choice removes the need to test. eesel CLI is not an Assistants-compatible endpoint, and it does not automatically migrate your application. Moving the support job means configuring its sources, instructions, integrations, and approvals, then checking the result.

Put one support scenario through the new setup

Before expanding a rollout, choose a scenario with a clear expected outcome: a warranty question with enough information to answer, one with a missing purchase date, and one requiring escalation. Review both the response and any actions.

eesel AI helpdesk dashboard overview. The CLI operates the same teammate available in this dashboard.
eesel AI helpdesk dashboard overview. The CLI operates the same teammate available in this dashboard.

If that support job is what you need, Try eesel and follow the CLI documentation. You can inspect the setup from your terminal while the support team reviews the same teammate in the dashboard.

Frequently asked questions

Is the OpenAI Assistants API still available?
No. OpenAI’s migration documentation states that it retired on August 26, 2026 and is no longer available. Use the Responses API for a new OpenAI integration.
What replaces Assistants, Threads, and Runs?
OpenAI maps Assistant configuration to prompts, Threads to Conversations, and Runs to Responses. This is a conceptual mapping, not a guarantee that existing IDs, request bodies, or application code transfer unchanged.
Does Responses require manually storing every conversation?
No. You can use a persistent Conversation, chain calls with previous_response_id, or manage prior items yourself. Choose the approach that fits your retention and application requirements.
Does file search send every uploaded document into every request?
File search retrieves relevant information from a vector store using semantic and keyword search. Do not estimate costs by assuming that every uploaded file is always included in full. Measure the actual input, output, storage, and tool usage.
Is eesel CLI a drop-in replacement for the Assistants API?
No. It operates an eesel teammate rather than accepting your existing Assistants API requests. If you move a support job to eesel, configure its sources, instructions, integrations, and action permissions, then test its behavior separately.
Can a coding agent use eesel CLI to configure support?
Yes. Claude Code, Cursor, or Codex can run CLI commands and inspect JSON results. The CLI uses the same agent and workspace as the dashboard. Give the coding agent a bounded task and specify which changes require your approval.
Will using eesel CLI eliminate all migration work?
No. eesel handles its own underlying service implementation, but your own application, integrations, and CLI scripts still need maintenance. A custom app migration to Responses remains separate from setting up an eesel teammate.

Share this article

Kenneth Pangan

Article by

Kenneth Pangan

Writer and marketer for over ten years, Kenneth Pangan splits his time between history, politics, and art with plenty of interruptions from his dogs demanding attention.

Related Posts

All posts →
The 5 best GPT-5 Pro in the API alternatives for 2025
Guides

The 5 best GPT-5 Pro in the API alternatives for 2025

OpenAI’s GPT-5 Pro API is a game-changer, but its cost and complexity aren't for everyone. We break down the best GPT-5 Pro in the API alternatives for 2025, comparing platforms like eesel AI with powerful models like Claude and Gemini to help you choose the right solution for your business.

Stevia PutriStevia PutriOct 8, 2025
The 7 best AI documentation assistants I tested in 2026
Guides

The 7 best AI documentation assistants I tested in 2026

Tired of endless documentation work? I tested the 7 best AI documentation assistants in 2026 — including eesel AI, Mintlify, and Notion AI — to see which tools actually save time and keep docs accurate.

Kurnia Kharisma Agung SamiadjieKurnia Kharisma Agung SamiadjieOct 22, 2025
I tested the top 5 OpenAI Codex alternatives in 2026 (Here’s my verdict)
Guides

12 best OpenAI Codex alternatives by use case (2026)

Looking for the best OpenAI Codex alternatives in 2026? After the original model was deprecated, a new wave of AI coding assistants emerged. I break down the top 5 tools for developers, from CLI-first agents to deeply integrated IDEs, to help you find the perfect fit for your workflow.

Kurnia Kharisma Agung SamiadjieKurnia Kharisma Agung SamiadjieOct 8, 2025
Image alt text
Guides

I tested the top 5 OpenAI frontier alternatives in 2026 (here’s my verdict)

Explore the best OpenAI frontier alternatives. A practical guide comparing eesel AI, Anthropic, Google, Cohere, and Mistral for enterprise use.

Stevia PutriStevia PutriFeb 6, 2026
A guide to the Gorgias GraphQL API: Use cases & alternatives
Guides

A guide to the Gorgias GraphQL API: Use cases & alternatives

The Gorgias GraphQL API offers powerful automation for sophisticated workflows. Discover its potential and see how no-code AI tools can complement your setup to achieve goals quickly.

Kenneth PanganKenneth PanganOct 26, 2025
A practical guide to Zendesk API development: What it is and when to use an alternative
Guides

A practical guide to Zendesk API development: What it is and when to use an alternative

Thinking about Zendesk API development? This guide covers what it is, its powerful use cases, and key considerations like resource allocation and maintenance. Discover how modern AI platforms offer a streamlined, no-code path to complement your Zendesk setup.

Kenneth PanganKenneth PanganOct 22, 2025
The 7 best AI scheduling assistant tools in 2025
Guides

7 best AI scheduling assistants in 2026 (we tested them)

From client calls to deep work, here are the best AI scheduling assistants in 2025 to finally take the chaos out of your calendar.

Kenneth PanganKenneth PanganAug 21, 2025
The 7 best Salesforce AI assistants to boost productivity in 2025
Guides

The 7 best Salesforce AI assistants to boost productivity in 2025

Tired of sifting through endless options? We reviewed the top Salesforce AI assistants to help you automate tasks, improve workflows, and boost productivity in 2025.

Kenneth PanganKenneth PanganNov 14, 2025
I tested a dozen AI assistants to find the best Brave Leo alternatives in 2025
Guides

I tested a dozen AI assistants to find the best Brave Leo alternatives in 2025

Tired of weighing privacy against features? We tested the top Brave Leo alternatives to find the best AI assistants for every need, from personal browsing to professional team support.

Kenneth PanganKenneth PanganOct 26, 2025

Ready to hire your AI teammate?

Set up in minutes. No credit card required.

Get started free