---
title: "Create Interaction"
method: POST
path: "/v1beta/interactions"
tags: ["google genai endpoints", "interactions"]
---

# Create Interaction

`POST /v1beta/interactions`

## Request

- Base URL: `https://api.vibebrowser.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.vibebrowser.app/v1beta/interactions`
- Auth: one of:
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`

Create a new interaction using Google's Interactions API.

Per OpenAPI spec: POST /{api_version}/interactions

Supports both model interactions and agent interactions:
- Model: Provide `model` parameter (e.g., "gemini-2.5-flash")
- Agent: Provide `agent` parameter (e.g., "deep-research-pro-preview-12-2025")

Example:
```bash
curl -X POST "http://localhost:4000/v1beta/interactions"         -H "Authorization: Bearer sk-1234"         -H "Content-Type: application/json"         -d '{
        "model": "gemini/gemini-2.5-flash",
        "input": "Hello, how are you?"
    }'
```

## Response `200`

Successful Response

- unknown

---

[API](https://skmtc.dev/vibebrowser/apis/litellm-api.md) · [All operations](https://skmtc.dev/vibebrowser/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vibebrowser/apis/litellm-api/revisions/eea0b7e7b167?raw)