Skip to content

docs: update Responses API page for Gemini stateful conversations - #1072

Open
naresh4dev wants to merge 6 commits into
mainfrom
feat/gemini-interactions-api
Open

naresh4dev wants to merge 6 commits into
mainfrom
feat/gemini-interactions-api

Conversation

@naresh4dev

Copy link
Copy Markdown
Member

Summary

Update the Responses API docs to reflect Google Gemini and Vertex AI as native providers with previous_response_id support.

Related: gateway-enterprise-node PR #2063

Changes

  • Provider lists: Move Google Gemini and Vertex AI from adapter to native providers
  • New section: "Stateful Conversations (previous_response_id)" with Python, JavaScript, and cURL examples
  • Native-Only Features: Updated to document Google support for previous_response_id, store, and retrieve/delete operations
  • Info callout: Notes that Portkey maps previous_response_id to Gemini's native previous_interaction_id via the Interactions API

…tags

Add a comprehensive guide covering end-to-end setup for forwarding
Portkey metadata as AWS STS session tags during Bedrock AssumeRole calls.
Covers gateway configuration, IAM permissions (caller + target trust
policy), SDK/cURL examples, CloudTrail verification, Cost Explorer
activation, tag sanitisation constraints, credential caching, and
troubleshooting common errors.

Also updates the existing assumed-role doc with minimum gateway version,
clearer IAM guidance, and a cross-link to the new cookbook.
- Replace real AWS account IDs and role names in the troubleshooting
  error example with generic placeholders
- Expand the Credential Caching section with: cache key composition
  table, TTL details, cache backend (Redis vs in-memory), when new
  AssumeRole calls happen, STS call volume estimation formula, and
  a note about throttling for high-cardinality metadata
Remove the raw cache key format string (internal implementation detail)
while keeping the parameter table and 'not in cache key' clarification
that are useful for users.
Replace the box-drawing character diagram with a Mermaid sequenceDiagram
that Mintlify renders natively with interactive zoom/pan controls.
- Move IAM permission setup (caller policy + trust policy) to Step 1
- Move gateway env flag enablement to Step 2 with a warning to
  complete IAM setup first to avoid AccessDenied on all requests
- Add enterprise self-hosted note at the top
- Update all step references in troubleshooting section
- Move Google Gemini and Vertex AI from adapter to native providers list
- Add 'Stateful Conversations (previous_response_id)' section with
  Python, JavaScript, and cURL examples for Gemini
- Update Native-Only Features section to document Google support for
  previous_response_id, store, and retrieve/delete operations
- Note that Portkey maps previous_response_id to Gemini's native
  previous_interaction_id via the Interactions API
@mintlify

mintlify Bot commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
portkey-docs 🟢 Ready View Preview Sep 14, 2026, 9:38 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant