---
title: "List connectors"
method: GET
path: "/v1beta/connectors"
tags: ["Connectors"]
---

# List connectors

`GET /v1beta/connectors`

## Request

- Base URL: `https://api.indices.io`
- URL: `https://api.indices.io/v1beta/connectors`
- Auth: HTTP bearer

List the connectors in your catalog.

## Query parameters

- `limit` integer: Maximum number of connectors to return.
- `cursor` string: Cursor from a previous response's `next_cursor`, to fetch the next page.
- `domain` string: Only connectors whose website is this domain or a subdomain of it.

## Response `200`

Successful response

- ListConnectorsResponse
  - `data` Connector[], required: Connectors for the requested page, ordered newest first.
    - `id` string, required: Unique identifier for the object.
    - `display_name` string, required: Short human-readable name of the connector.
    - `purpose` string, required: What the connector does, as specified at publish time.
    - `website` string, nullable, required: Website the connector operates against.
    - `input_schema` object, required: JSON Schema for the connector's run arguments.
    - `output_schema` object, required: JSON Schema for the connector's run results.
    - `required_secrets` SecretSlotDefinition[]: Secret slots that must be bound when running the connector.
      - `name` string, required: Name of the secret slot, used as the key in a run's secret_bindings.
      - `type` 'login' | 'string', required
      - `supports_totp` boolean: Whether the connector can perform 2FA/TOTP when the bound login has it configured. Logins without TOTP remain bindable. Only applicable for 'login' type.
      - `description` string, nullable: What the bound secret is used for, when the connector declares it.
    - `version` integer, required: Version of the connector, starting at 1 and incremented by each revision.
    - `created_at` string, date-time, required: Timestamp when the object was created.
  - `has_more` boolean, required: Whether more connectors exist after this page.
  - `next_cursor` string, nullable, required: Pass as the `cursor` query parameter to fetch the next page. Null when has_more is false.

## Other responses

- `422`: Validation error

---

[API](https://skmtc.dev/indices/apis/indices-api.md) · [All operations](https://skmtc.dev/indices/apis/indices-api/llms.txt) · [OpenAPI document](https://skmtc.dev/indices/apis/indices-api/revisions/e0f2742c126c?raw)