Skip to main content
Slug: COMPOSIO_MANAGE_CONNECTIONS Tags: openWorldHint, destructiveHint Checks connection status for a toolkit and returns a branded authentication link when the user needs to connect, covering OAuth, API keys, and every other auth type.

When to use it

Call COMPOSIO_MANAGE_CONNECTIONS when COMPOSIO_SEARCH_TOOLS reports that a toolkit has no active connection. You must have an active connection before you execute any tool from that toolkit.
When the tool returns a redirect_url, show it to the user as a formatted markdown link and wait for the connection to go active before executing. Set reinitiate_all to force a fresh connection when credentials are stale.

Input parameters

array<string>
required
Toolkit slugs to check or connect. Must be valid toolkit slugs; never invent. Missing connections initiate auth. Examples: [‘gmail’, ‘github’, ‘slack’, ‘googlesheets’, ‘outlook’].
boolean
Force reconnection for all listed toolkits, even if active connections already exist. Use when credentials may be stale, you need fresh credentials/settings, or you are troubleshooting connection issues. This replaces existing active connections with new auth-link flows. Default false. Default: False.
string
Pass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.

Response

object
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
Whether or not the action execution was successful or not