TAtavus
Connectors

Get Connector

Changed on

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

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

Response

Connector returned

connector_idstring

The unique identifier of the connector. Use this everywhere a connector is referenced, including layers.mcp.connectors on a PAL.

owner_idinteger

The account that owns the connector.

team_idinteger nullable

Team the connector belongs to, when applicable.

namestring

Human-readable name. Also the basis of the label the background agent sees for this service.

sourcestring

Connector kind. mcp today.

server_urlstring

The MCP server endpoint.

auth_configobject

How Tavus authenticates to the server, with secrets removed. See the create request for the accepted shapes.

selected_tool_namesstring[] 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.

oauth_scopesstring[] nullable

Scopes granted by the authorization server.

access_token_expires_atstring nullable

When the current access token expires. Tavus refreshes it automatically while the connector stays linked.

last_indexed_atstring nullable

When tools were last imported from the server. null if never indexed.

last_index_errorstring nullable

Why the last import failed, if it did.

created_atstring
updated_atstring

Example response

{
  "connector_id": "c8-58ea0f6420b2",
  "owner_id": 4309,
  "team_id": null,
  "name": "Linear",
  "source": "mcp",
  "server_url": "https://mcp.linear.app/mcp",
  "auth_config": {
    "type": "oauth2"
  },
  "selected_tool_names": null,
  "oauth_status": "linked",
  "oauth_scopes": [
    "read",
    "write"
  ],
  "access_token_expires_at": "2026-08-18T09:14:00",
  "last_indexed_at": "2026-08-17T18:20:11",
  "last_index_error": null,
  "created_at": "2026-08-17T18:02:56.838918",
  "updated_at": "2026-08-17T18:20:11.563911"
}

Changes