Conversation Grouping

Group related requests together so logs and analytics can be viewed at the conversation level.

How It Works

Pass an X-Conversation-Id header on every request that belongs to the same conversation. The gateway attaches the ID to each log entry and uses it to combine those entries into a single conversation view in the dashboard.

X-Conversation-Id: chat_2025_04_29_alice_001

The header is optional by default. If Enforce Conversation ID is enabled on the API key, requests without it are rejected.

ID Format

Allowed characters: alphanumeric, -, _, and .. The ID is generated by your application, typically once per chat session, and reused across every turn in that session.

Enforce Conversation ID

Mode	Behavior
Enabled	Every request must include a valid X-Conversation-Id. Requests without it are rejected.
Disabled (default)	Header is read and used for grouping if present, otherwise the request is logged on its own.

Toggle this per API key from the dashboard.