restore_connector_access

Purpose

The dashboard's Restore Access for agents. An uninstall leaves every place on the connector detached and revokes its grants; once the connector is installed and connected again, this asks the connector about every detached place, reactivates the ones it still controls, and hands every live purchase of a plan granting them fresh access — only the grants a purchase lacks are issued, which are exactly the ones the uninstall took away, and member.resource_added fires per grant. A place the connector no longer controls stays detached for run_connector_doctor to explain. Plans the uninstall took off sale stay off sale.

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": {
    "installation": { "id": "3b8f0c6e-2d41-4a97-9e5f-1c7d6b2a8e40", "connector": "telegram", "state": "connected" },
    "connector": "telegram",
    "resources": [
      { "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6", "title": "Premium Channel", "restored": true },
      { "resource_id": "0d4a7e19-5c2b-4f83-9a61-2e8b7c3d5f10", "title": "Archive Group", "restored": false }
    ],
    "resources_reactivated": 1,
    "resources_still_detached": 1,
    "subscriptions_reissued": 14
  },
  "meta": {}
}

Example prompts

"I reinstalled Telegram on the Signals project — bring the channels back and give everyone their access again."

"Restore access on the Research project's connector and tell me which places did not come back."

Failure modes

• AUTHENTICATION_REQUIRED — no authenticated user on the request.
• TOKEN_MISSING_ABILITY — token lacks project-connector:update.
• RESOURCE_NOT_FOUND — the project is unknown or outside the token's reach.
• CONNECTOR_NOT_INSTALLED — the project has no installation of the connector.
• CONNECTOR_NOT_CONNECTED — the installation is pending or disconnected; connect it and verify it first.

Related

• uninstall_connector — what detaches the places in the first place.
• install_connector — brings an uninstalled row back as pending.
• run_connector_doctor — why a place stayed detached.
• Connectors API