v27

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2193427579.9 KB
Interactions

Create an interaction.

Create an interaction using the Google Interactions API format.

post/v1alpha/interactions

Request body

modelstring required

The model to use for generation.

system_instructionstring nullable

System prompt.

previous_interaction_idstring nullable

ID of a previous interaction to continue the conversation from.

streamboolean nullable

Whether to stream the response via SSE.

response_modalitiesstring[] nullable

Accepted response modalities (e.g. ['TEXT']). Accepted for compatibility, ignored in v1.

Response

A GoogleInteractionResponse or a stream of Google SSE events.

idstring required

Unique interaction ID.

createdstring nullable

Creation timestamp.

status'completed'
updatedstring nullable

Last update timestamp.

modelstring required

Model used for generation.

role'model'
object'interaction'