google · Google AI Docs
Gemini API Interactions API: Breaking changes migration guide (May 2026)
A guide detailing the specific breaking changes to the Interactions API scheduled for May 2026 and the necessary steps to migrate existing implementations.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Gemini API Interactions API: Breaking changes migration guide (May 2026)
A guide detailing the specific breaking changes to the Interactions API scheduled for May 2026 and the necessary steps to migrate existing implementations.
When To Use
Use when updating existing Interactions API implementations to ensure compatibility with the May 2026 breaking changes.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/gemini-api-interactions-breaking-changes-migration-guide-may-2026-workflow-guide.md | A guide detailing the restructuring of the Gemini API Interactions API from outputs to steps and providing legacy Python code comparisons. | Questions about a guide detailing the restructuring of the Gemini API Interactions API from outputs to steps and providing legacy Pyt... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini.text | A Python code snippet demonstrating the updated syntax for creating interactions and accessing response outputs following the May 2026 breaking changes. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating the updated syntax for creating interactions and accessing response outputs follo... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-2.text | A code example demonstrating the updated syntax for creating interactions and accessing outputs in the Gemini API following the May 2026 breaking changes. | Exact payloads, commands, or snippets shown in A code example demonstrating the updated syntax for creating interactions and accessing outputs in the Gemini API fol... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-3.text | A curl command demonstrating the updated POST request structure for the Gemini API Interactions endpoint. | Exact payloads, commands, or snippets shown in A curl command demonstrating the updated POST request structure for the Gemini API Interactions endpoint. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-4.text | A text representation of the updated response object structure following the Gemini API Interactions API breaking changes. | Exact payloads, commands, or snippets shown in A text representation of the updated response object structure following the Gemini API Interactions API breaking cha... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-5.text | A Python code example demonstrating the updated request and response structure for the Gemini API Interactions API following the May 2026 breaking changes. | Exact payloads, commands, or snippets shown in A Python code example demonstrating the updated request and response structure for the Gemini API Interactions API fo... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-6.text | A Node.js code example demonstrating the updated syntax for creating interactions and accessing response content following the May 2026 breaking changes. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating the updated syntax for creating interactions and accessing response content foll... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-7.text | A curl command demonstrating how to opt-in to the Gemini API Interactions API using the Api-Revision header. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to opt-in to the Gemini API Interactions API using the Api-Revision header. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-8.text | A text representation of the updated POST response schema and GET interaction timeline structure for the Gemini API Interactions API. | Exact payloads, commands, or snippets shown in A text representation of the updated POST response schema and GET interaction timeline structure for the Gemini API I... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-9.text | A text snippet demonstrating how to access function call names and arguments using the legacy schema within interaction outputs. | Exact payloads, commands, or snippets shown in A text snippet demonstrating how to access function call names and arguments using the legacy schema within interacti... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-10.text | A code snippet demonstrating how to access function call data using the legacy schema structure during the Gemini API interactions migration. | Exact payloads, commands, or snippets shown in A code snippet demonstrating how to access function call data using the legacy schema structure during the Gemini API... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-11.text | A text representation of the updated Gemini API response structure featuring thought and function call output types. | Exact payloads, commands, or snippets shown in A text representation of the updated Gemini API response structure featuring thought and function call output types. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-12.text | A code snippet demonstrating how to access function call data within the updated steps schema for the Gemini API Interactions API. | Exact payloads, commands, or snippets shown in A code snippet demonstrating how to access function call data within the updated steps schema for the Gemini API Inte... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-13.text | A code snippet demonstrating how to access function call data within the updated interaction steps schema. | Exact payloads, commands, or snippets shown in A code snippet demonstrating how to access function call data within the updated interaction steps schema. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-14.text | A text representation of a POST response body illustrating the new structure for status, steps, and function calls in the Gemini API Interactions API. | Exact payloads, commands, or snippets shown in A text representation of a POST response body illustrating the new structure for status, steps, and function calls in... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-15.text | A text snippet demonstrating how to access search results using the legacy schema within the interaction outputs object. | Exact payloads, commands, or snippets shown in A text snippet demonstrating how to access search results using the legacy schema within the interaction outputs object. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-16.text | A code snippet demonstrating how to access search results using the legacy schema for the Gemini API Interactions API. | Exact payloads, commands, or snippets shown in A code snippet demonstrating how to access search results using the legacy schema for the Gemini API Interactions API. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-17.text | A curl command demonstrating a POST request to the Gemini API interactions endpoint using the v1beta version. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini API interactions endpoint using the v1beta version. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-18.text | A text representation of the updated JSON response structure for Gemini API interactions following the May 2026 breaking changes. | Exact payloads, commands, or snippets shown in A text representation of the updated JSON response structure for Gemini API interactions following the May 2026 break... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-19.text | A code snippet demonstrating how to iterate through interaction steps to access Google Search call arguments and search result suggestions in the new schema. | Exact payloads, commands, or snippets shown in A code snippet demonstrating how to iterate through interaction steps to access Google Search call arguments and sear... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-20.text | A code snippet demonstrating how to access search results using the updated steps schema for Google Search calls in the Gemini API. | Exact payloads, commands, or snippets shown in A code snippet demonstrating how to access search results using the updated steps schema for Google Search calls in t... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-21.text | A curl command demonstrating the required API-Revision header and payload structure to opt-in to the Gemini API Interactions API changes. | Exact payloads, commands, or snippets shown in A curl command demonstrating the required API-Revision header and payload structure to opt-in to the Gemini API Inter... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-22.text | A text representation of a POST response body showing the updated structure for google-search-call and model-output steps. | Exact payloads, commands, or snippets shown in A text representation of a POST response body showing the updated structure for google-search-call and model-output s... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-23.text | A code example demonstrating the legacy streaming method using content.delta for the Gemini API Interactions API. | Exact payloads, commands, or snippets shown in A code example demonstrating the legacy streaming method using content.delta for the Gemini API Interactions API. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-24.text | A code example demonstrating the migration from the legacy content.delta streaming event type to the updated Gemini API interactions structure. | Exact payloads, commands, or snippets shown in A code example demonstrating the migration from the legacy content.delta streaming event type to the updated Gemini A... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-25.text | A curl command demonstrating a POST request to the Gemini API interactions endpoint using the v1beta version. | Exact payloads, commands, or snippets shown in A curl command demonstrating a POST request to the Gemini API interactions endpoint using the v1beta version. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-26.text | An example of the Server-Sent Events (SSE) line format used in Gemini API interaction responses. | Exact payloads, commands, or snippets shown in An example of the Server-Sent Events (SSE) line format used in Gemini API interaction responses. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-27.text | A Python code example demonstrating how to consume a stream and handle the updated step.delta event type for the Gemini API. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to consume a stream and handle the updated step.delta event type for the Gemi... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-28.text | A Node.js code example demonstrating how to consume a stream and handle the updated step.delta event type for the Gemini API Interactions API. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to consume a stream and handle the updated step.delta event type for the Gem... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-29.text | A curl command demonstrating the required API revision header and endpoint for opting into the Gemini API Interactions API changes. | Exact payloads, commands, or snippets shown in A curl command demonstrating the required API revision header and endpoint for opting into the Gemini API Interaction... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-30.text | A text representation of Server-Sent Events (SSE) lines showing the updated interaction event data structure for the Gemini API. | Exact payloads, commands, or snippets shown in A text representation of Server-Sent Events (SSE) lines showing the updated interaction event data structure for the... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-31.text | A Python code example demonstrating the updated syntax for creating interactions using the Gemini API following the May 2026 breaking changes. | Exact payloads, commands, or snippets shown in A Python code example demonstrating the updated syntax for creating interactions using the Gemini API following the M... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-32.text | A JavaScript code snippet demonstrating the syntax for creating a new interaction using the Gemini API interactions client. | Exact payloads, commands, or snippets shown in A JavaScript code snippet demonstrating the syntax for creating a new interaction using the Gemini API interactions c... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-33.text | A curl command demonstrating the updated POST request structure for the Gemini API Interactions endpoint. | Exact payloads, commands, or snippets shown in A curl command demonstrating the updated POST request structure for the Gemini API Interactions endpoint. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-34.text | A Python code example demonstrating the updated syntax for the create interaction method following the May 2026 breaking changes. | Exact payloads, commands, or snippets shown in A Python code example demonstrating the updated syntax for the create interaction method following the May 2026 break... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-35.text | A Node.js code example demonstrating the migration from responseMimeType to the new responseFormat object structure in the Gemini API Interactions API. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating the migration from responseMimeType to the new responseFormat object structure i... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-36.text | A curl command demonstrating the required API-Revision header and POST request structure to opt-in to the Gemini API Interactions API changes. | Exact payloads, commands, or snippets shown in A curl command demonstrating the required API-Revision header and POST request structure to opt-in to the Gemini API... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-37.text | A code snippet demonstrating the updated syntax for the client.interactions.create method following the May 2026 breaking changes. | Exact payloads, commands, or snippets shown in A code snippet demonstrating the updated syntax for the client.interactions.create method following the May 2026 brea... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-38.text | A Node.js code snippet demonstrating the updated syntax for creating an interaction using the Gemini API interactions method. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating the updated syntax for creating an interaction using the Gemini API interactions... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-39.text | A curl command demonstrating the updated POST request structure for the Gemini API Interactions endpoint. | Exact payloads, commands, or snippets shown in A curl command demonstrating the updated POST request structure for the Gemini API Interactions endpoint. |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-40.text | A code example demonstrating the migration from imageconfig in generationconfig to the new responseformat structure for image generation in the Gemini API. | Exact payloads, commands, or snippets shown in A code example demonstrating the migration from imageconfig in generationconfig to the new responseformat structure f... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-41.text | A code example demonstrating the migration from imageConfig to responseFormat within the Gemini API interactions create method. | Exact payloads, commands, or snippets shown in A code example demonstrating the migration from imageConfig to responseFormat within the Gemini API interactions crea... |
examples/gemini-api-interactions-breaking-changes-migration-guide-may-2026-gemini-42.text | A curl command demonstrating how to opt-in to the Gemini API Interactions API using the Api-Revision header. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to opt-in to the Gemini API Interactions API using the Api-Revision header. |
What This Skill Covers
- Interactions API: Breaking changes migration guide (May 2026)
- Main sections:
Core change: outputs to steps,Basic input/output (unary),Before (legacy),Python,JavaScript.
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://ai.google.dev/gemini-api/docs/interactions-breaking-changes-may-2026