---
title: "Get Connector"
method: GET
path: "/v2/connectors/{connector_id}"
tags: ["Connectors"]
---

# Get Connector

`GET /v2/connectors/{connector_id}`

## Request

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

Returns a single connector. Secrets are omitted; check `oauth_status` to see whether an OAuth connector is usable.

## Response `200`

Connector returned

- Connector: An MCP server you have registered. Secret material is never returned: `auth_config` comes back with its `type` and non-secret fields only, and OAuth tokens are omitted entirely.
  - `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

## Other responses

- `404`: Connector not found

## Changes

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

[Operation history](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/changes/v2/connectors/:connector_id/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/932c24e63be2?raw)