From c2f7a2040d2e541e8e5f7817aadbb5c661548295 Mon Sep 17 00:00:00 2001 From: Pavel Tiunov Date: Mon, 5 Jan 2026 09:27:11 -0800 Subject: [PATCH] docs: Ephemeral user warnings --- .../pages/product/apis-integrations/embed-apis/chat-api.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/pages/product/apis-integrations/embed-apis/chat-api.mdx b/docs/pages/product/apis-integrations/embed-apis/chat-api.mdx index 5cb010d77e84f..d536b42565a3e 100644 --- a/docs/pages/product/apis-integrations/embed-apis/chat-api.mdx +++ b/docs/pages/product/apis-integrations/embed-apis/chat-api.mdx @@ -27,9 +27,13 @@ The Chat API enables real-time streaming conversations with Cube's AI agents. Th ## Authentication -Accounts are limited to 10,000 external users. To increase this limit, please contact support. +Accounts are limited to 10,000 non-ephemeral external users. To increase this limit, please contact support. + +All users created using this API are ephemeral by default and will be removed after `sessionSettings.ephemeralTtlSeconds` (1 week by default). If users need to be persisted, pass `isEphemeral: false` in `sessionSettings`. Ephemeral users are guaranteed to not live longer than `sessionSettings.ephemeralTtlSeconds`. + + Pass your [API key][ref-api-keys] directly to the Chat API endpoint. The session will be created automatically based on the `externalId` provided: ```javascript