> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tai42.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# tai connectors

> Manage connector providers and connections.

Manage connector providers and connections.

```console theme={null}
$ tai connectors [OPTIONS] COMMAND [ARGS]...
```

## `tai connectors connect`

Start a connection flow; prints the authorize URL (or the created connection).

Example: `tai connectors connect google --alias work --sub-service gmail`

```console theme={null}
$ tai connectors connect [OPTIONS] PROVIDER
```

| Argument   | Description               |
| ---------- | ------------------------- |
| `PROVIDER` | Provider id. *(required)* |

| Option                 | Description                                                          |
| ---------------------- | -------------------------------------------------------------------- |
| `--alias` `TEXT`       | A unique alias for the new connection.                               |
| `--sub-service` `TEXT` | An enabled sub-service (repeatable).                                 |
| `--config` `TEXT`      | Provider config values as a JSON object.                             |
| `--return-url` `TEXT`  | Where to return after the flow completes. *(default: `/connectors`)* |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.                               |

## `tai connectors connections`

List the installed connections (no secrets).

Example: `tai connectors connections`

```console theme={null}
$ tai connectors connections [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai connectors disconnect`

Disconnect (delete) a connection.

Example: `tai connectors disconnect conn_123`

```console theme={null}
$ tai connectors disconnect [OPTIONS] CONNECTION_ID
```

| Argument        | Description                 |
| --------------- | --------------------------- |
| `CONNECTION_ID` | Connection id. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai connectors get`

Get one connection.

Example: `tai connectors get conn_123`

```console theme={null}
$ tai connectors get [OPTIONS] CONNECTION_ID
```

| Argument        | Description                 |
| --------------- | --------------------------- |
| `CONNECTION_ID` | Connection id. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai connectors providers`

List the available connector providers.

Example: `tai connectors providers`

```console theme={null}
$ tai connectors providers [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai connectors reconnect`

Start a reconnect (re-authorize) flow for an existing connection.

Example: `tai connectors reconnect conn_123 --sub-service gmail`

```console theme={null}
$ tai connectors reconnect [OPTIONS] CONNECTION_ID
```

| Argument        | Description                 |
| --------------- | --------------------------- |
| `CONNECTION_ID` | Connection id. *(required)* |

| Option                 | Description                                                          |
| ---------------------- | -------------------------------------------------------------------- |
| `--sub-service` `TEXT` | An enabled sub-service (repeatable).                                 |
| `--return-url` `TEXT`  | Where to return after the flow completes. *(default: `/connectors`)* |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.                               |

## `tai connectors sub-services`

Change a connection's enabled sub-services.

Example: `tai connectors sub-services conn_123 --sub-service gmail --sub-service calendar`

```console theme={null}
$ tai connectors sub-services [OPTIONS] CONNECTION_ID
```

| Argument        | Description                 |
| --------------- | --------------------------- |
| `CONNECTION_ID` | Connection id. *(required)* |

| Option                 | Description                                                        |
| ---------------------- | ------------------------------------------------------------------ |
| `--sub-service` `TEXT` | The desired enabled sub-service (repeatable).                      |
| `--return-url` `TEXT`  | Where to return if consent is required. *(default: `/connectors`)* |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.                             |