> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Connections

> Create or manage connections to user's apps

**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.

> [!NOTE]
>
> 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

**toolkits** `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'].

**reinitiate\_all** `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`.

**session\_id** `string`

Pass the session\_id if you received one from a prior COMPOSIO\_SEARCH\_TOOLS call.

## Response

**data** `object`

Data from the action execution

**properties**

**message** `string`

Overall status message

**results** `object`

Connection results for each toolkit

**summary** `object`

Summary of results by status type

**properties**

**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 }

**properties**

**id** `string`

**instructions** `string`

**error** `string`

Error if any occurred during the execution of the action

**successful** `boolean`

Whether or not the action execution was successful or not
