Connections

Refresh a remote MCP connection’s tools

Lists the tools the remote MCP server shows THIS connection (with its own credential) again, now, and applies the result to the connector’s registry; a tool new to it is usable at once. A remote MCP connection also refreshes when it becomes active and once a day; this is the on-demand one. No body. Same mutation bar as reconnect (can_manage); render controls on the connection’s can_refresh_tools, which is present only on a remote MCP connection. Rate limited to one per connection per minute: 429 with Retry-After. The 200 carries the diff as tool NAMES (summary.added, changed, removed, tier_changed, and tier_changes with each tier's direction), never definitions. 403 connector_not_shared when the connector's owner stopped sharing it; 409: not_remote_mcp, not_refreshable (not active or not bound), needs_reauth (the server rejected the credential; the connection is moved to needs_reauth), or tools_refresh_failed (the message is safe to show and is also on the row as tools_refresh_error).

post/connection/{id}/refresh-tools

Request

  • Base URL: https://api.elaichi.ai
  • URL: https://api.elaichi.ai/connection/{id}/refresh-tools
  • Auth: HTTP bearer

Path parameters

idstring required

Connection id (conn_…).

Headers

X-Organization-Idstring

Target organization (org_…). Required for cookie/session auth on org-scoped routes; optional for API tokens, which carry their organization, and rejected when it names a different one.

Response

OK

listedinteger required

Tools this connection lists now.

tools_refreshed_atstring date-time nullable required
tools_refresh_errorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.