# Manage Connections

**Slug:** `COMPOSIO_MANAGE_CONNECTIONS`
**Tags:** openWorldHint

## Input Parameters

- `toolkits` (array<string>) *(required)*: List of toolkits to check or connect. Should be a valid toolkit returned by SEARCH_TOOLS (never invent one). If a toolkit is not connected, will initiate connection. Example: ['gmail', 'exa', 'github', 'outlook', 'reddit', 'googlesheets', 'one_drive']
- `reinitiate_all` (boolean): Force reconnection for ALL toolkits in the toolkits list, even if they already have Active connections.               WHEN TO USE:               - You suspect existing connections are stale or broken.               - You want to refresh all connections with new credentials or settings.               - You're troubleshooting connection issues across multiple toolkits.               BEHAVIOR:               - Overrides any existing active connections for all specified toolkits and initiates new link-based authentication flows.               DEFAULT: false (preserve existing active connections) (default: `false`)
- `session_id` (string): ALWAYS pass the session_id that was provided in the SEARCH_TOOLS response.

## Response

- `data` (object) *(required)*: Data from the action execution
  - `message` (string) *(required)*: Overall status message
  - `results` (object) *(required)*: Connection results for each toolkit
  - `summary` (object) *(required)*: Summary of results by status type
    - `total_toolkits` (integer)
    - `active_connections` (integer)
    - `initiated_connections` (integer)
    - `failed_connections` (integer)
  - `session` (object): Session info echoed back to reinforce reuse: { id: string, instructions: string }
    - `id` (string) *(required)*
    - `instructions` (string) *(required)*
- `error` (string): Error if any occurred during the execution of the action
- `successful` (boolean) *(required)*: Whether or not the action execution was successful or not


---

📚 **More documentation:** [View all docs](https://docs.composio.dev/llms.txt) | [Glossary](https://docs.composio.dev/llms.mdx/docs/glossary) | [Cookbooks](https://docs.composio.dev/llms.mdx/cookbooks) | [API Reference](https://docs.composio.dev/llms.mdx/reference)