verify_connector_installation
Ask the connector whether a project's installation still answers, and record the verdict on it.
A fresh probe rather than the hourly one. The connector is asked about the installation and the answer is recorded: state becomes connected, degraded (with state_reason, state_detail and whether the creator can fix it) or revoked, and health_checked_at is stamped. A pending installation has nothing to verify and is returned as it is. The REST twin is POST /v1/projects/{project}/connectors/{key}/installation/verify.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Fires one event
Delivered to every endpoint subscribed to it once the change is made.
Annotations
Sending the same arguments twice changes nothing the second time.
Arguments
project_id*stringUUID of the project.
connector*stringThe connector key, as `list_connectors` returns it.
What it returns
{ "data": { "id": "3b8f0c6e-2d41-4a97-9e5f-1c7d6b2a8e40", "connector": "telegram", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "scope": "project", "role": "live", "state": "degraded", "state_reason": "connector_api_unauthorized", "state_detail": "The token was revoked in @BotFather.", "creator_actionable": true, "operational": true, "external_id": "7123456789", "display_name": "Research Bot", "handle": "research_bot", "avatar_url": null, "health_checked_at": "2026-09-12T10:07:00+00:00", "connected_at": "2026-04-21T09:15:00+00:00", "verified_at": "2026-09-11T06:00:00+00:00", "revoked_at": null, "disconnected_at": null, "uninstalled_at": null, "created_at": "2026-04-21T09:15:00+00:00" }, "meta": {}}How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-connector:update.
RESOURCE_NOT_FOUNDthe project is not visible to this token, or context.reason is unknown_connector.
CONNECTOR_NOT_INSTALLEDthe project has no installation of the connector.
Events emitted
connector.status_changedonly when the state moved.
How is this guide?
Last updated on