---
title: "List connectors"
method: GET
path: "/connectors"
---

# List connectors

`GET /connectors`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/connectors`
- Auth: HTTP bearer

Tenant-bound connector configuration. No provider requests. Credentials are masked. Mutations require the current revision where applicable. Referenced connections and nonempty connectors cannot be deleted. New custom connector and action creation requires workspace rollout enablement.

## Query parameters

- `cursor` string

## Response `200`

Success

- ConnectorsPage
  - `connectors` Connector[], required
    - `connectorId` string, required
    - `tenantId` string
    - `kind` 'custom' | 'provider' | 'builtin' | 'legacy', required
    - `provider` string
    - `name` string, required
    - `description` string
    - `revision` integer
    - `createdAt` string
    - `updatedAt` string
    - `connectionCount` integer
    - `attentionCount` integer
    - `inventoryComplete` boolean
    - `actionFamily` 'http' | 'collection': Missing means http for existing custom connectors.
    - `hasActions` boolean: Built-in Visito group contains existing ungrouped collection actions.
  - `nextCursor` string, nullable, required
  - `canCreate` boolean, required

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)
