Skip to content
X-Buddy
Tiếng Việt

API reference

Find operations

tools_search — Search every X-Buddy operation this connection may run (not only the tools shown now): returns up to 5 matches with their input fields.

Markdown version

tools_search · Reads saved data

Search every X-Buddy operation this connection may run (not only the tools shown now): returns up to 5 matches with their input fields. Then call execute_read (R / L) or execute_write (X / W / D) with the operation id.
REST GET /api/public/v1/operations/search
MCP tool tools_search
Permission needed view — Owner, Manager, Operator, Viewer
Scope group accounts:read
Group Indirect calls and docs
Shown up front in profiles every profile (core set)

Input

Field Type Required Description
query string (2–200 chars) Yes What you want to do, e.g. 'pin a post', 'campaign funnel', 'add people to a list'.
domain string (0–30 chars) No Optional domain filter (x_write, tasks, campaigns, posts, audience, growth, inbox, reports, infra…).
kind R · L · X · W · D No Optional kind filter.

Result

Returned in the { data, meta } envelope, without creating a job on X. Lists include next_cursor and has_more.

Example

Call over REST

curl -X GET "https://reach-link-craft.lovable.app/api/public/v1/operations/search?query=ai+agents" \
  -H "Authorization: Bearer $XBUDDY_API_KEY"

Call over MCP

{
  "method": "tools/call",
  "params": {
    "name": "tools_search",
    "arguments": {
      "query": "ai agents"
    }
  }
}

Errors you may get

Code HTTP Retryable
unauthorized 401 No
key_expired 401 No
integration_revoked 401 No
connection_not_linked 403 No
integration_paused 403 No
workspace_integrations_paused 403 No
integration_authorization_lost 403 No
workspace_suspended 403 No
forbidden 403 No
invalid_input 422 No
rate_limited 429 Yes
internal 500 Yes

Back to all operations