---
title: "List Connector Operations"
method: GET
path: "/v1/tools/connectors/{connector_id}/operations"
tags: ["API v1", "Tools", "Tools Discovery"]
---

# List Connector Operations

`GET /v1/tools/connectors/{connector_id}/operations`

## Request

- Base URL: `https://api.xpander.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xpander.ai/v1/tools/connectors/{connector_id}/operations`
- Auth: API key in header `x-api-key`

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

## Path parameters

- `connector_id` string, required

## Query parameters

- `connection_id` string, required: The connection to list operations for.
- `query` string, nullable: Optional operation search query.

## Response `200`

Successful Response

- ConnectorOperationItem[]
  - `id` string, required: Unique identifier for this operation. Use this as item_id when adding the operation to an agent's tool graph.
  - `operationId` string, required: The OpenAPI operationId — a stable, human-readable identifier for this endpoint (e.g., 'sendMessage', 'createIssue').
  - `path` string, required: API endpoint path (e.g., '/api/v1/messages', '/rest/api/3/issue'). May contain path parameters in {brackets}.
  - `method` string, required: HTTP method for this operation (GET, POST, PUT, DELETE, PATCH).
  - `summary` string, nullable: Brief one-line summary of what this operation does.
  - `description` string, nullable: Detailed description of the operation, including parameters, behavior, and response format.
  - `tags` string[], nullable: Categorization tags for grouping related operations (e.g., 'Messages', 'Users', 'Issues').
  - `pretty_name` string, nullable: Human-friendly name for the operation (e.g., 'Send Message', 'Create Issue'). More readable than the operationId.
  - `pretty_description` string, nullable: Enhanced description of the operation, potentially AI-generated for better clarity.
  - `effect_kind` 'read' | 'write' | 'depends', nullable: Whether calling this operation reads or writes: 'read', 'write', or 'depends' when the request body decides (for example a SQL statement).

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xpander/apis/xpander-ai-api-service.md) - [All operations](https://skmtc.dev/xpander/apis/xpander-ai-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/xpander/apis/xpander-ai-api-service/revisions/725c0066d5df?raw)