# uip is connectors

> `uip is connectors` browses the Integration Service connector catalog — every integration the tenant can authenticate against (Salesforce, Slack, Zoho Desk, etc.). It is read-only: list returns the catalog, get returns the full record for one connector by key. Both verbs cache results per-tenant on disk; pass `--refresh` to force a fresh fetch.

`uip is connectors` browses the Integration Service connector catalog — every integration the tenant can authenticate against (Salesforce, Slack, Zoho Desk, etc.). It is read-only: list returns the catalog, get returns the full record for one connector by key. Both verbs cache results per-tenant on disk; pass `--refresh` to force a fresh fetch.

## Synopsis

```
uip is connectors <verb> [options]
```

## Verbs

| Verb | Purpose |
|---|---|
| `list` | List connectors available to the tenant; optionally filter by name or key. |
| `get` | Fetch full details for one connector by key. |

## uip is connectors list

List connectors available to the current tenant. Cached per-tenant on disk.

### Options

| Short | Long | Value | Default | Description |
|---|---|---|---|---|
| `-t` | `--tenant` | name | session default | Override the tenant selected at auth time. |
| `-f` | `--filter` | text | — | Substring match against connector name or key. |
| — | `--refresh` | flag | off | Force re-fetch from the API, ignoring cache. |

### Examples

```bash
uip is connectors list

uip is connectors list --filter zoho

uip is connectors list --filter slack \
    --output-filter 'Data[].{name:Name, key:Key}'
```

### Data shape (--output json)

```json
{
  "Code": "ConnectorList",
  "Data": [
    {
      "Id": 492,
      "Name": "Zoho Desk",
      "Key": "uipath-zoho-desk",
      "Vendor": "",
      "Active": "No",
      "Version": "",
      "Stage": "",
      "DapCompatible": "No"
    }
  ]
}
```

If no connectors match, the command succeeds with `Code: "Message"` and `Data: { "Message": "No connectors found." }`.

## uip is connectors get

Return the full record for one connector by key.

### Arguments

| Name | Required | Purpose |
|---|---|---|
| `<connector-key>` | yes | Connector key, for example `uipath-zoho-desk`. Find it with `connectors list`. |

### Options

| Short | Long | Value | Default | Description |
|---|---|---|---|---|
| `-t` | `--tenant` | name | session default | Override the tenant. |

### Examples

```bash
uip is connectors get uipath-zoho-desk

uip is connectors get uipath-zoho-desk \
    --output-filter 'Data[0].{events:HasEvents, cruds:HasCruds}'
```

### Data shape (--output json)

```json
{
  "Code": "Connector",
  "Data": [
    {
      "Id": 492,
      "Name": "Zoho Desk",
      "Key": "uipath-zoho-desk",
      "Description": "Zoho Desk streamlines customer service...",
      "HasEvents": "Yes",
      "HasCruds": "No",
      "HasMethods": "No",
      "DapCompatible": "No",
      "Categories": "IT and help desk",
      "Tags": "Service desk, Agents, Tickets",
      "Tier": "2"
    }
  ]
}
```

Full field list (all returned): `Id`, `Name`, `Key`, `AppName`, `Vendor`, `Description`, `Active`, `Version`, `LifecycleStage`, `DiscoveryType`, `DefaultAuth`, `HasEvents`, `HasCruds`, `HasMethods`, `DapCompatible`, `MinDapVersion`, `ActivityPackVersion`, `ActivityColor`, `Categories`, `Tags`, `DocumentationUrl`, `Guid`, `Tier`, `CreatedAt`, `UpdatedAt`.

## Related

- [`uip is connections`](./uip-is-connections.md) — create OAuth sessions against the connectors discovered here.
- [`uip is activities`](./uip-is-activities.md) — list the operations a connector exposes.
- [`uip is resources`](./uip-is-resources.md) — describe and execute a connector's data-plane objects.
- [`uip is triggers`](./uip-is-triggers.md) — event-driven connector operations.

## See also

- [Integration Service tool overview](./uip-is.md)
- [Global options](./global-options.md)
- [Exit codes](./exit-codes.md)