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

# Connect

> Look up Connect operators and teams from the CLI to route the human-handoff nodes in your workflows.

`jelou connect` lists the **operators** and **teams** in Connect, Jelou's human
handoff. It is read-only: use it to get the ids you need when configuring a
human-handoff node in a workflow.

<Note>
  Human-handoff nodes route to an operator id, or to a team id when they use
  `assignmentBy: "TEAM"`. These commands are how you find those ids without going
  into the Studio.
</Note>

## Operators

```bash theme={null}
jelou connect operators list                      # active only (default)
jelou connect operators list --include-inactive   # includes inactive and deleted
jelou connect operators list --json
```

| Flag                 | Description                                    |
| -------------------- | ---------------------------------------------- |
| `--include-inactive` | Include inactive or deleted operators          |
| `--out <path>`       | Write the JSON to a file in addition to stdout |

By default it returns **active** operators only. Inactive ones still exist in the
organization, but routing a conversation to them does nothing.

## Teams

```bash theme={null}
jelou connect teams list                      # active only (default)
jelou connect teams list --include-inactive
jelou connect teams list --json
```

| Flag                 | Description                                    |
| -------------------- | ---------------------------------------------- |
| `--include-inactive` | Include inactive teams                         |
| `--out <path>`       | Write the JSON to a file in addition to stdout |

## Capture the listing to a file

`--out` writes the same JSON to disk, handy for saving the ids before editing
several workflows:

```bash theme={null}
jelou connect operators list --json --out operators.json
jelou connect teams list --json --out teams.json
```

<Warning>
  The target directory for `--out` must already exist; the CLI does not create it.
</Warning>