Struct InteractionRequest 

pub struct InteractionRequest {

    pub model: Option<String>,
    pub agent: Option<String>,
    pub agent_config: Option<AgentConfig>,
    pub input: InteractionInput,
    pub previous_interaction_id: Option<String>,
    pub tools: Option<Vec<Tool>>,
    pub response_modalities: Option<Vec<String>>,
    pub response_format: Option<Value>,
    pub response_mime_type: Option<String>,
    pub generation_config: Option<GenerationConfig>,
    pub stream: Option<bool>,
    pub background: Option<bool>,
    pub store: Option<bool>,
    pub system_instruction: Option<InteractionInput>,
}

Request body for the Interactions API endpoint.

This type represents a fully-constructed interaction request that can be cloned, serialized, and executed via Client::execute().

Creating Requests

Use InteractionBuilder::build() to create requests:

let client = Client::new("api_key".to_string());

let request = client.interaction()
    .with_model("gemini-3-flash-preview")
    .with_text("Hello!")
    .build()?;

// Request can be cloned, serialized, inspected
let backup = request.clone();
println!("{}", serde_json::to_string_pretty(&request)?);

Executing Requests

let response = client.execute(request).await?;

Retrying Requests

Since InteractionRequest is Clone, you can retry failed requests:

let response = loop {
    match client.execute(request.clone()).await {
        Ok(r) => break r,
        Err(e) if e.is_retryable() => continue,
        Err(e) => return Err(e.into()),
    }
};

Fields

model: Option<String>

Model name (e.g., “gemini-3-flash-preview”) - mutually exclusive with agent

agent: Option<String>

Agent name (e.g., “deep-research-pro-preview-12-2025”) - mutually exclusive with model

agent_config: Option<AgentConfig>

Agent-specific configuration (e.g., Deep Research thinking summaries)

input: InteractionInput

The input for this interaction

previous_interaction_id: Option<String>

Reference to a previous interaction for stateful conversations

tools: Option<Vec<Tool>>

Tools available for function calling

response_modalities: Option<Vec<String>>

Response modalities (e.g., [“IMAGE”])

response_format: Option<Value>

JSON schema for structured output

response_mime_type: Option<String>

Response MIME type for structured output.

Required when using response_format with a JSON schema. Typically “application/json”.

generation_config: Option<GenerationConfig>

Model configuration

stream: Option<bool>

Enable streaming responses

background: Option<bool>

Background execution mode (agents only)

store: Option<bool>

Persist interaction data (default: true)

system_instruction: Option<InteractionInput>

System instruction for the model

Trait Implementations

impl Clone for InteractionRequest

fn clone(&self) -> InteractionRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InteractionRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InteractionRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InteractionRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.