> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tavus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Connectors

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



## OpenAPI

````yaml get /v2/connectors
openapi: 3.0.3
info:
  title: Tavus Developer API Collection
  version: 1.0.0
  contact: {}
servers:
  - url: https://tavusapi.com
security:
  - apiKey: []
tags:
  - name: Videos
  - name: Faces
  - name: Voices
  - name: Conversations
  - name: Deployments
  - name: PALs
  - name: Tools
  - name: PAL Tools
  - name: Connectors
  - name: Pronunciation Dictionaries
  - name: Replacements
  - name: Transcriptions
  - name: Documents
  - name: Memory Stores
paths:
  /v2/connectors:
    get:
      tags:
        - Connectors
      summary: List Connectors
      description: Every connector you own, newest first. Deleted connectors are omitted.
      operationId: listConnectors
      responses:
        '200':
          description: Connectors returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/connector'
components:
  schemas:
    connector:
      type: object
      description: >-
        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.
      example:
        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'
      properties:
        connector_id:
          type: string
          description: >-
            The unique identifier of the connector. Use this everywhere a
            connector is referenced, including `layers.mcp.connectors` on a PAL.
          example: c8-58ea0f6420b2
        owner_id:
          type: integer
          description: The account that owns the connector.
          example: 4309
        team_id:
          type: integer
          nullable: true
          description: Team the connector belongs to, when applicable.
          example: null
        name:
          type: string
          description: >-
            Human-readable name. Also the basis of the label the background
            agent sees for this service.
          example: Linear
        source:
          type: string
          description: Connector kind. `mcp` today.
          example: mcp
        server_url:
          type: string
          description: The MCP server endpoint.
          example: https://mcp.linear.app/mcp
        auth_config:
          type: object
          description: >-
            How Tavus authenticates to the server, with secrets removed. See the
            create request for the accepted shapes.
          example:
            type: oauth2
        selected_tool_names:
          type: array
          nullable: true
          deprecated: true
          description: >-
            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`.
          items:
            type: string
          example: null
        oauth_status:
          type: string
          description: >-
            `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).
          enum:
            - none
            - pending
            - linked
            - needs_reauth
          example: linked
        oauth_scopes:
          type: array
          nullable: true
          description: Scopes granted by the authorization server.
          items:
            type: string
          example:
            - read
            - write
        access_token_expires_at:
          type: string
          nullable: true
          description: >-
            When the current access token expires. Tavus refreshes it
            automatically while the connector stays `linked`.
          example: '2026-08-18T09:14:00'
        last_indexed_at:
          type: string
          nullable: true
          description: >-
            When tools were last imported from the server. `null` if never
            indexed.
          example: '2026-08-17T18:20:11'
        last_index_error:
          type: string
          nullable: true
          description: Why the last import failed, if it did.
          example: null
        created_at:
          type: string
          example: '2026-08-17T18:02:56.838918'
        updated_at:
          type: string
          example: '2026-08-17T18:20:11.563911'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````