Skip to main content
GET
/
v1
/
connectors
/
{connector_id}
/
{connection_id}
/
operations
/
search
Search Operations
curl --request GET \
  --url https://api.example.com/v1/connectors/{connector_id}/{connection_id}/operations/search \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "<string>",
    "operationId": "<string>",
    "path": "<string>",
    "method": "<string>",
    "summary": "<string>",
    "description": "<string>",
    "tags": [],
    "pretty_name": "<string>",
    "pretty_description": "<string>"
  }
]
Search for specific operations within a connector connection using fuzzy matching against name, summary, and description fields.

​
Path Parameters

​
connector_id
string
required
Unique identifier of the connector
​
connection_id
string
required
Unique identifier of the connection

​
Query Parameters

​
query
string
required
Search query to match against operation name, summary, and description

​
Response

Returns an array of ConnectorOperationItem objects matching the search query.

​
Example Request

curl -X GET -H "x-api-key: <your-api-key>" \
  "https://api.xpander.ai/v1/connectors/<connector-id>/<connection-id>/operations/search?query=send+message"

​
Notes

  • Useful for finding specific operations in connectors with many available endpoints
  • Matches against pretty_name, summary, and description fields

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Path Parameters

​
connector_id
string
required
​
connection_id
string
required

Query Parameters

​
query
string
required

Search query to match against operation name, summary, and description

Response

Successful Response

​
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 | null

Brief one-line summary of what this operation does.

​
description
string | null

Detailed description of the operation, including parameters, behavior, and response format.

​
tags
string[] | null

Categorization tags for grouping related operations (e.g., 'Messages', 'Users', 'Issues').

​
pretty_name
string | null

Human-friendly name for the operation (e.g., 'Send Message', 'Create Issue'). More readable than the operationId.

​
pretty_description
string | null

Enhanced description of the operation, potentially AI-generated for better clarity.