Hi team,
I’ve noticed several documentation issues and inconsistencies on the Interactions API docs page:
Before filing GitHub issues, I wanted to ask:
Which GitHub repository is the correct place to report documentation bugs for ai.google.dev (specifically Interactions API docs)?
I checked the following repos, but they appear to be SDK-specific rather than docs ownership:
Could someone point me to:
the correct public repo for documentation issues, or
confirm that documentation bugs should be reported only via this forum / feedback widget?
Happy to file a proper issue(s) once I know the right place.
Thanks!
Hi @Prasad_Karmarkar That’s right - the issues reported on the Github repos linked above are specific to genai SDKs. Please use this forum to bring up any docs issues related to Interactions API. Thank you for checking with us!
1 Like
sure. Here are the issues
The Interactions API documentation contains an incorrect example response for the Deep Research agent.
Documentation URL:
The example response shows "role": "model", but the actual API response returns "role": "agent".
Steps to Reproduce
Run the curl example provided in the documentation:
curl -X POST https://generativelanguage.googleapis.com/v1beta/interactions \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent": "deep-research-pro-previ…
Environment
API: v1beta/interactions
Model: gemini-3-flash-preview
Client: curl / Java SDK
Docs URL: https://ai.google.dev/api/interactions-api#CreateInteraction-function_calling
The Interactions API documentation contains an incorrect response example for function calling.
In the documented example, the function_call object inside outputs does not include an id field. However, the actual API always returns an id for function_call outputs.
This results in a documented response sc…