Skip to content
aicoolies logo
OpenAI Assistants API logo

OpenAI Assistants API

Discontinued

Thread-based AI assistant API with tools and file support

OpenAI's platform API for building stateful AI assistants. Manages conversation threads, supports function calling, code interpreter, and file search (RAG) out of the box. Usage-based pricing makes it accessible for startups and enterprises alike, with built-in memory and tool orchestration for production-grade conversational applications.

About OpenAI Assistants API

The OpenAI Assistants API is a server-side platform for building AI assistants with persistent threads, built-in tools, and managed conversation state, eliminating the need for developers to manually manage chat history and context windows. It solves the challenge of building stateful AI applications by providing server-managed conversation threads, automatic context window management, and access to OpenAI-hosted tools including Code Interpreter for running Python code, File Search for RAG over uploaded documents, and function calling for third-party integrations. The Assistants API represented OpenAI's first major step toward making AI agents programmable through a managed API service.

The Assistants API provides persistent threads that maintain conversation history across sessions, automatic file handling with support for various document formats, Code Interpreter with a sandboxed Python execution environment, File Search with built-in chunking and embedding for RAG workflows, and streaming support for real-time response delivery. Assistants can be configured with custom instructions, multiple tools, and specific model parameters, with the ability to attach files at both the assistant and thread level. The API handles all the complexity of context window management, tool execution, and result formatting behind a clean REST interface.

The OpenAI Assistants API targets developers building AI-powered applications that require persistent state, tool use, and managed infrastructure, from customer support bots to research assistants and automated analysis tools. However, OpenAI has announced a deprecation plan with a target sunset date of August 2026, recommending that new projects use the Responses API instead, which provides better performance, new features like MCP support, deep research, and computer use, along with the Agents SDK for building more sophisticated agent workflows. Existing Assistants API users should plan migration to the Responses API and Agents SDK to take advantage of the latest OpenAI platform capabilities.

Pricing & Platform Specs

Pricing Summary

Usage-based pay-as-you-go developer API. Charges are based on underlying model token consumption (e.g., GPT-4o input/output tokens) plus tool execution fees: Code Interpreter costs $0.03 per active session (up to 1 hour), and File Search vector storage costs $0.10/GB/day (first 1 GB free) with $2.50 per 1,000 tool calls.

Supported Platforms

REST API, Python SDK, Node.js SDK

Why it was discontinued

discontinued August 26, 2026

OpenAI deprecated the Assistants API after achieving feature parity in the Responses API. It will shut down on August 26, 2026. Existing integrations should migrate to the Responses API using OpenAI's official migration guide: https://developers.openai.com/api/docs/assistants/migration

use instead: LangChain, LlamaIndex, Vercel AI SDK

Explore categories, tags & use cases

Framework for LLM applications

The most widely-used framework for building LLM-powered applications, available in Python and JavaScript. Provides abstractions for chains, agents, RAG, memory, tool usage, and structured output. Integrates with 100+ LLM providers, vector stores, document loaders, and tools. LangSmith offers tracing and evaluation. LangGraph enables stateful, multi-agent workflows with cycles. 100K+ GitHub stars. The de facto standard for LLM application development despite growing alternatives like LlamaIndex.

freemiumOpen Source

Data framework for LLM applications

Leading Python framework for building LLM-powered applications with focus on data-aware and agentic workflows. Provides tools for RAG (Retrieval-Augmented Generation), document indexing, vector store integrations, query engines, and multi-agent orchestration. 150+ data connectors for various sources. Works with OpenAI, Anthropic, local models, and more. Includes LlamaHub for community tools and LlamaCloud for managed RAG pipelines. 50K+ GitHub stars.

freemiumOpen Source

Build AI-powered web apps

Open-source TypeScript toolkit by Vercel for building AI-powered apps with streaming chat UIs, structured outputs, tool calling, and agent workflows. Framework-agnostic core with integrations for React, Next.js, Svelte, Vue, and Nuxt. Supports a broad AI SDK v6 provider catalog including OpenAI, Anthropic, Google, xAI, Mistral, Bedrock, Groq, and OpenAI-compatible providers. Includes useChat and useCompletion hooks for rapid UI development. The standard SDK for adding AI features to web apps.

Open Source

Side-by-Side Comparisons

OpenAI Assistants API logo
OpenAI Assistants API
vs
OpenAI Agents SDK logo
OpenAI Agents SDK

OpenAI Assistants API vs OpenAI Agents SDK — Deprecated Managed Threads vs Modern Agent Runtime

OpenAI Assistants API and OpenAI Agents SDK represent two different eras of building agents on OpenAI. Assistants API bundled assistants, threads, and runs into a managed service that is now deprecated. Agents SDK is the modern Python runtime for orchestrating tools, handoffs, guardrails, sessions, tracing, and sandboxed work on top of newer OpenAI APIs.

OpenAI Assistants APIOpenAI Agents SDK

Community experience

Sources & verification

Sources checked
Content verified

Verification dates are editorial checks. Routine CMS saves and automatic updatedAt timestamps do not advance them.

FAQ

What is OpenAI Assistants API?

OpenAI's platform API for building stateful AI assistants. Manages conversation threads, supports function calling, code interpreter, and file search (RAG) out of the box. Usage-based pricing makes it accessible for startups and enterprises alike, with built-in memory and tool orchestration for production-grade conversational applications.

Is OpenAI Assistants API free?

No — OpenAI Assistants API is a paid tool. Usage-based pay-as-you-go developer API. Charges are based on underlying model token consumption (e.g., GPT-4o input/output tokens) plus tool execution fees: Code Interpreter costs $0.03 per active session (up to 1 hour), and File Search vector storage costs $0.10/GB/day (first 1 GB free) with $2.50 per 1,000 tool calls.

Is OpenAI Assistants API still available?

No — OpenAI Assistants API was discontinued on August 26, 2026. OpenAI deprecated the Assistants API after achieving feature parity in the Responses API. It will shut down on August 26, 2026. Existing integrations should migrate to the Responses API using OpenAI's official migration guide: https://developers.openai.com/api/docs/assistants/migration Consider LangChain, LlamaIndex, Vercel AI SDK instead.

What are the best OpenAI Assistants API alternatives?

The first editor-selected OpenAI Assistants API alternatives are LangChain, LlamaIndex, Vercel AI SDK.