Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 22, 09:30 UTC
docs: add session creation FAQ to users-and-sessions and common FAQs
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sushmithamallesh committed
Feb 17, 2026 at 16:08 UTC
0a37ffb2ff721c958c11e732dc1dad3ba32c39e7
2 files changed
+10
docs/content/docs/common-faq.mdx
+4
@@ -142,6 +142,10 @@ Composio does not have fixed IP ranges. Traffic is routed through Cloudflare and
142
<Accordion title="How do I increase my quota?">
143
Upgrade your plan. See [pricing](https://composio.dev/pricing) for available plans and limits.
144
</Accordion>
145
+<Accordion title="When should I create a new session?">
146
+Create a new session when the config changes: different toolkits, different auth config, or a different connected account. You don't need to store or manage session IDs. Just call `create()` each time. See [Users and sessions](/docs/users-and-sessions).
147
+</Accordion>
148
+
149
<Accordion title="How do I configure sessions with custom auth configs?">
150
Some toolkits require your own OAuth credentials or API keys. Create an auth config in the dashboard by selecting the toolkit, choosing the auth scheme, and entering your credentials. Then pass the auth config ID when creating a session using the `auth_configs` (or `auth_config_id`) parameter so the session uses your developer credentials instead of Composio-managed auth. See [Using custom auth configuration](/docs/using-custom-auth-configuration).
151
</Accordion>
docs/content/docs/users-and-sessions.mdx
+6
@@ -113,6 +113,12 @@ This means the boundary for a new session isn't a new chat or a new request. It'
113
114
Connections are tied to the user ID, not the session. A user who connected Gmail in one session can access it in every future session without re-authenticating.
115
116
+<Accordions>
117
+<Accordion title="When should I create a new session?">
118
+Create a new session when the config changes: different toolkits, different auth config, or a different connected account. You don't need to store or manage session IDs. Just call `create()` each time.
119
+</Accordion>
120
+</Accordions>
121
+
122
<Cards>
123
<Card icon={<BookOpen />} title="Configuring Sessions" href="/docs/configuring-sessions" description="Enable toolkits, set auth configs, and select connected accounts" />
124
<Card icon={<BookOpen />} title="Workbench" href="/docs/workbench" description="Write and run code in a persistent sandbox" />