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

# List Connectors

`GET /v2/connectors`

## Request

- Base URL: `https://tavusapi.com`
- URL: `https://tavusapi.com/v2/connectors`
- Auth: API key in header `x-api-key`

Every connector you own, newest first. Deleted connectors are omitted.

## Response `200`

Connectors returned

- object
  - `data` Connector[]
    - `connector_id` string: The unique identifier of the connector. Use this everywhere a connector is referenced, including `layers.mcp.connectors` on a PAL.
    - `owner_id` integer: The account that owns the connector.
    - `team_id` integer, nullable: Team the connector belongs to, when applicable.
    - `name` string: Human-readable name. Also the basis of the label the background agent sees for this service.
    - `source` string: Connector kind. `mcp` today.
    - `server_url` string: The MCP server endpoint.
    - `auth_config` object: How Tavus authenticates to the server, with secrets removed. See the create request for the accepted shapes.
    - `selected_tool_names` string[], nullable: Always `null` on connectors created today, and not settable: the create and update endpoints reject the field. A leftover from the removed tool importer - tool scoping is a per-PAL decision, so use `layers.mcp.connector_tools`.
    - `oauth_status` 'none' | 'pending' | 'linked' | 'needs_reauth': `none` for non-OAuth connectors. `pending` once an authorize URL has been issued but the flow is not finished. `linked` when Tavus holds a working token. `needs_reauth` when the refresh token stopped working - send the customer through [Reconnect OAuth](/api-reference/connectors/reconnect-connector-oauth).
    - `oauth_scopes` string[], nullable: Scopes granted by the authorization server.
    - `access_token_expires_at` string, nullable: When the current access token expires. Tavus refreshes it automatically while the connector stays `linked`.
    - `last_indexed_at` string, nullable: When tools were last imported from the server. `null` if never indexed.
    - `last_index_error` string, nullable: Why the last import failed, if it did.
    - `created_at` string
    - `updated_at` string

## Changes

- **2026-11-03** `932c24e63be2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/changes/v2/connectors/get.md)

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) - [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/revisions/60c89a007146?raw)