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

# List Connector Operations

> List (or search) a connection's operations. Use an operation's id as operation_id when attaching it to an agent.

Connections are organization-scoped — pass the `connection_id` of a connection you own.


## OpenAPI

````yaml GET /v1/tools/connectors/{connector_id}/operations
openapi: 3.1.0
info:
  title: xpander.ai API Service
  description: |2-

        The xpander.ai API Service provides a unified REST API for managing AI agents,
        executing tasks, managing knowledge bases, and integrating with external systems.
        
        Features:
        - Agent Management: Create, update, deploy, and delete AI agents
        - Task Execution: Invoke agents with support for sync, async, and streaming modes
        - Knowledge Bases: Manage knowledge bases and documents for RAG workflows
        - Tools: Discover, connect, and attach tools (connectors, custom functions, MCP servers, sub-agents, workflows) to agents and workflows
        - MCP Integration: Model Context Protocol support for standardized AI interactions
        
        Authentication: All endpoints require authentication via either an API key (`x-api-key`) or an OAuth2 JWT (`Authorization: Bearer <jwt>`).
        
  version: '0.001'
servers:
  - url: https://api.xpander.ai
security: []
paths:
  /v1/tools/connectors/{connector_id}/operations:
    get:
      tags:
        - API v1
        - Tools
        - Tools Discovery
      summary: List Connector Operations
      description: >-
        List (or search) a connector connection's operations. Use an operation's
        `id` as operation_id when attaching it to an agent.
      operationId: >-
        List_connector_operations_v1_tools_connectors__connector_id__operations_get
      parameters:
        - name: connector_id
          in: path
          required: true
          schema:
            type: string
            title: Connector Id
        - name: connection_id
          in: query
          required: true
          schema:
            type: string
            description: The connection to list operations for.
            title: Connection Id
          description: The connection to list operations for.
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Optional operation search query.
            title: Query
          description: Optional operation search query.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConnectorOperationItem'
                title: >-
                  Response List Connector Operations V1 Tools Connectors 
                  Connector Id  Operations Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    ConnectorOperationItem:
      properties:
        id:
          type: string
          title: Id
          description: >-
            Unique identifier for this operation. Use this as item_id when
            adding the operation to an agent's tool graph.
        operationId:
          type: string
          title: Operationid
          description: >-
            The OpenAPI operationId — a stable, human-readable identifier for
            this endpoint (e.g., 'sendMessage', 'createIssue').
        path:
          type: string
          title: Path
          description: >-
            API endpoint path (e.g., '/api/v1/messages', '/rest/api/3/issue').
            May contain path parameters in {brackets}.
        method:
          type: string
          title: Method
          description: HTTP method for this operation (GET, POST, PUT, DELETE, PATCH).
        summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary
          description: Brief one-line summary of what this operation does.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: >-
            Detailed description of the operation, including parameters,
            behavior, and response format.
        tags:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Tags
          description: >-
            Categorization tags for grouping related operations (e.g.,
            'Messages', 'Users', 'Issues').
          default: []
        pretty_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Pretty Name
          description: >-
            Human-friendly name for the operation (e.g., 'Send Message', 'Create
            Issue'). More readable than the operationId.
        pretty_description:
          anyOf:
            - type: string
            - type: 'null'
          title: Pretty Description
          description: >-
            Enhanced description of the operation, potentially AI-generated for
            better clarity.
      type: object
      required:
        - id
        - operationId
        - path
        - method
      title: ConnectorOperationItem
      description: |-
        An available API operation (endpoint) within a connector.

        Operations are the individual API actions you can perform through a
        connector (e.g., 'Send Slack message', 'Create Jira issue'). Each
        operation maps to an endpoint in the connector's OpenAPI specification.

        To add an operation to an agent's tool graph, use the operation's `id`
        as the `item_id` in an AIAgentGraphItem.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      description: API Key for authentication
      in: header
      name: x-api-key

````