Documentation
Version
Platform Dashboard GuideREST API ReferenceMCP Server for AI AgentsBuilding ConnectorsWebhooks & EventsAutomations & Integrations
WRITE

restore_connector_access

Bring a project's detached places on a reinstalled connector back and hand every live purchase of a plan granting them fresh access.

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.

Requires ability

project-connector:update

The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.

Runs the same action as

POST/v1/projects/{project}/connectors/{key}/installation/restore-access

The REST endpoint and this tool share one action, so validation, permissions and events are identical.

Fires one event

member.resource_added

Delivered to every endpoint subscribed to it once the change is made.

Annotations

Idempotent

Sending the same arguments twice changes nothing the second time.

Arguments

project_id*string

UUID of the project.

connector*string

The connector key, as `list_connectors` returns it.

What it returns

{  "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": {}}

How it fails

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_connectorwhat detaches the places in the first place.install_connectorbrings an uninstalled row back as pending.run_connector_doctorwhy a place stayed detached.Connectors API

How is this guide?

Last updated on

list_connectors

List the Connectors Marketplace — every connector Subscriby knows, lane by lane, with its badges, manifest and the form that connects it.

run_connector_doctor

Verify a project's installation of a connector and ask the connector about every resource it gates — one report, a finding per check.