COMPOSIO_MANAGE_CONNECTIONSExternalDestructiveChecks 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
toolkitsarray<string>RequiredToolkit slugs to check or connect. Must be valid toolkit slugs; never invent. Missing connections initiate auth. Examples: ['gmail', 'github', 'slack', 'googlesheets', 'outlook'].
reinitiate_allbooleanDefault: falseForce 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.
session_idstringPass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.
Response
dataobjectData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanWhether or not the action execution was successful or not