Gemini API Interactions breaking changes (May 2026): outputs → steps, new response_format, and migration timeline
Google’s Gemini API Interactions endpoint is changing its response schema (outputs → steps), consolidating output format controls into response_format, and updating streaming event names, with a May 26 default flip and a June 8 legacy sunset.
Editorial Team
The Authority AI Tools editorial team maintains this directory using vendor documentation, dated source checks, product changelogs, and clearly identified hands-on observations where available.
Google published a migration guide for upcoming breaking changes to the Gemini API Interactions endpoint, including a response schema change from outputs to steps, plus a firm timeline for rollout. (https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026)
1) Response schema: outputs → steps
Google says responses move from a flat outputs array to a structured steps array:
POST /interactionsreturns only output steps.GET /interactions/{id}returns the full step timeline (including the initialuser_inputstep).
(https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026)
2) Output format changes: response_mime_type removed
Google says response_mime_type is removed and output control moves into a polymorphic response_format field.
The guide also notes that image output configuration previously under generation_config.image_config moves into a response_format entry with type: "image". (https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026)
3) Streaming event names change
Google’s guide lists new server-sent-event types (e.g. interaction.created, interaction.completed, step.start, step.delta, step.stop) replacing older event names. (https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026)
For streaming function calls, Google says function arguments arrive as partial JSON string deltas (arguments_delta), and clients must accumulate deltas to reconstruct full arguments. (https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026)
Migration timeline (key dates)
The guide lists a staged rollout:
- May 7, 2026: opt-in starts (REST API opt-in via
Api-Revision: 2026-05-20; SDK users upgrade to Python ≥2.0.0 / JS ≥2.0.0). (https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026) - May 26, 2026: new schema becomes the default; REST API users can temporarily opt out via
Api-Revision: 2026-05-07. (https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026) - June 8, 2026: legacy schema is removed for Interactions;
Api-Revisionis ignored. (https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026)
Sources
- Google AI for Developers migration guide: https://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026
Free Resource
2026 AI Coding Tools Comparison Chart
Side-by-side comparison of features, pricing, and capabilities for every major AI coding tool.
No spam, unsubscribe anytime.
Frequently Asked Questions
What is Gemini API Interactions breaking changes (May 2026): outputs → steps, new response_format, and migration timeline?
Related Articles
Warp adds GPT-6.1 Sol for Codex and ChatGPT subscribers
Warp’s September 29 announcement says GPT-6.1 Sol is available in Warp for use with a Codex or ChatGPT subscription.
Read more →Product UpdatesOpenAI DevDay 2026 brings Codex Cloud, code review, and Security Cloud
OpenAI’s September 2026 Codex updates add reusable cloud workspaces, automatic code review, and scheduled GitHub repository security scans.
Read more →Product UpdatesOpenAI Decisions API: Public Beta, Endpoint & Use Cases
OpenAI’s Decisions API is in public beta with GPT-6 Luna. See the /v1/decisions endpoint, text and image inputs, typed answers, and use cases.
Read more →