verify_connector_installation
Ask the connector whether a project's installation still answers, and record the verdict on it.
Purpose
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.
Required ability
project-connector:update
Input schema
{
"type": "object",
"required": ["project_id", "connector"],
"properties": {
"project_id": {
"type": "string",
"description": "UUID of the project."
},
"connector": {
"type": "string",
"description": "The connector key, as list_connectors returns it."
}
}
}Output shape
{
"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": {}
}Events emitted
connector.status_changedonly when the state moved.
Example prompts
"Check whether the Telegram bot on Research Premium still works."
Failure modes
AUTHENTICATION_REQUIRED— no authenticated user on the request.TOKEN_MISSING_ABILITY— token lacksproject-connector:update.RESOURCE_NOT_FOUND— the project is not visible to this token, orcontext.reasonisunknown_connector.CONNECTOR_NOT_INSTALLED— the project has no installation of the connector.
Related
get_connector_installation— the row without a fresh probe.list_recovery_incidents— what a degraded verdict may have opened.- Connectors API
How is this guide?
update_connector_installation_settings
Change a project's connector installation settings, validated against the fields the connector declares.
get_recovery_allowances
Read how many self-service Disaster Recoveries of each kind the creator the token acts for may still run, what support has released on top, and when the allowance returns. Takes no input.