Updated 27 Aug 2026: The Aug 26 shutdown date has now passed. Updates the dossier from pre-deadline warning to completed shutdown, preserving the same Responses/Conversations migration guidance and retention caveats.

Key details

  1. OpenAI listed August 26, 2026 as the Assistants API shutdown date; that date has now passed.
  2. OpenAI defines shutdown or sunset as the point when a deprecated endpoint is no longer accessible.
  3. Developers were notified of the deprecation on August 26, 2025.
  4. OpenAI recommends the Responses API and Conversations API as replacements.
  5. Assistants map to Prompts, Threads to Conversations, Runs to Responses and Run Steps to Items.
  6. The migration changes state and execution concepts, not just endpoint names.
  7. Retention does not map one-to-one: undeleted Assistants-related objects can persist indefinitely, stored Responses state has a 30-day default retention period, and Conversations/items are retained until deleted.

What builders should take away

  1. Search production code, queues, cron jobs and background workers for any remaining Assistants API usage; the migration deadline is no longer in the future.
  2. Create a migration matrix for Assistants→Prompts, Threads→Conversations and Runs→Responses so application-owned IDs and database relationships are deliberately remapped.
  3. Run end-to-end tests for tool calls, retries, streaming, file search and conversation persistence. A response that works in a simple prompt test is not enough evidence that an agent workflow is equivalent.
  4. Remove or quarantine code that silently falls back to Assistants; a dead fallback can mask migration defects and turn them into runtime failures.
  5. Review retention and deletion behavior for both Responses and Conversations during migration, especially if your product promises specific privacy, compliance or data-lifecycle guarantees.

What changed

OpenAI’s Assistants API reached its scheduled shutdown on August 26, 2026, exactly one year after developers were notified of the deprecation. OpenAI’s deprecation policy defines shutdown or sunset as the point when a model or endpoint is no longer accessible, and its current deprecations table lists the Assistants API removal date as August 26 with Responses and Conversations as the recommended replacements. The migration path replaces Assistants with Prompts, Threads with Conversations, Runs with Responses and Run Steps with generalized Items, while also changing how applications manage state and tool-calling loops.

Why it matters

This is now an operational failure boundary rather than a future deadline. Any production SaaS, internal tool or agent workflow that still depends on Assistants endpoints must migrate rather than plan to migrate. The replacement is not purely a renamed endpoint; state management and execution concepts differ enough that teams should test behavioural equivalence, tool calls and persistence rather than treating the change as a mechanical URL swap.

The shutdown date has passed

OpenAI’s deprecations page lists August 26, 2026 as the removal date for the Assistants API and defines shutdown or sunset as the point when the endpoint is no longer accessible. Responses API and Conversations API remain the recommended replacements.

The object model changes

The migration guide maps Assistants to Prompts, Threads to Conversations, Runs to Responses and Run Steps to Items. Responses accept input items and return output items; Conversations hold state across interactions. Tool-call loops are managed explicitly, so applications that relied on Run semantics need to re-check their orchestration logic.

Retention semantics need a separate migration check

OpenAI's current data-controls documentation says Assistants-related objects such as Assistants, Threads, Messages, Runs and Vector Stores retain application state until deleted; objects related to the Assistants API are removed from OpenAI's servers 30 days after deletion, while undeleted objects can remain indefinitely. Responses application state has a 30-day retention period by default when stored, while Conversations and conversation items are retained until deleted. Teams with privacy, compliance or contractual data-lifecycle promises should therefore verify deletion and retention behavior explicitly rather than assuming the replacement APIs inherit Assistants semantics.

The replacement API is where newer capabilities live

OpenAI positions Responses as its forward path for agent development and documents access to capabilities such as MCP, computer use and deep research there. With Assistants retired, the strategic direction and the operational requirement now point to the same API family.

Migration needs production-level validation

Teams should inventory every place an Assistant, Thread, Run or Run Step was created or read, then test persistence, retries, streaming, tool execution and file-search behaviour under the replacement APIs. The highest-risk integrations are those where Assistants state is deeply coupled to application-level user or job records.

What to watch next

  • Any post-shutdown operational guidance from OpenAI for customers who missed the deadline.
  • Operational reports from developers moving long-lived Threads and tool-heavy agents to Conversations and Responses.
  • Whether any Assistants-era features behave differently enough after migration to require product-level changes rather than API-only changes.

Still unclear

  • OpenAI's documentation says Responses reached feature parity with Assistants, but feature parity does not guarantee identical behaviour for every production workflow, particularly where applications depend on Assistants-specific orchestration assumptions.

Sources

Direct reading behind this dossier.

3 sources
Deprecations | OpenAI API
OpenAI primary

Primary deprecation table confirming September 24 shutdown, affected model aliases and no recommended replacement.

Discussion

Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.

0 visible comments

Join the discussion

Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.

Sign in to comment