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

request_resource_link

Ask the creator, through the connector, to pick the place a new resource will be; it appears the moment they choose.

Linking a place a connector gates is a conversation with the creator on the connector: only the platform can prove the installation administers the place, so the connector messages the creator with a picker and the resource appears, announced by project.resource.linked, the moment they choose. Nothing is created by this call itself; a manual perk is created with create_resource. The REST twin is POST /v1/projects/{project}/resources/link-requests.

Requires ability

project-resource:create

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}/resources/link-requests

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

project_id*string

UUID of the project the linked place will belong to.

kind*string

The kind of place to ask for, spelled `connector:kind`: a connector's key, a colon, and one of the `resource_kinds` that `list_connectors` lists for it.

{  "data": {    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",    "kind": "telegram:channel",    "status": "request_sent"  },  "meta": {}}
CONNECTOR_NOT_INSTALLED

the project runs no connected connector, so nothing could finish the link.

IDENTITY_NOT_LINKED

the creator holds no account linked on the connector that has to ask them; they link one under Settings → Security → Linked accounts and the call is retried.

VALIDATION_FAILED

kind is manual, a bare word or otherwise not connector:kind; no connected connector on the project gates the kind; or the creator's linked account cannot be messaged on the connector right now.

RESOURCE_NOT_FOUND

project_id is not a project the token can see.

AUTHENTICATION_REQUIRED

no authenticated user on the request.

TOKEN_MISSING_ABILITY

token lacks project-resource:create.

Related

create_resourcea manual perk, created outright.list_connectorsthe resource_kinds a connector gates, the values kind takes.list_resourcesthe resource appears here once the creator picks.project.resource.linkedfires when the creator picks.Resources API

How is this guide?

Last updated on

list_resources

Paginated list of project resources (the places a connector gates plus manual perks) scoped to one project, narrowable by kind and by connector.

unlink_resource

Clear the connector place from a resource, reverting it to an unlinked placeholder the creator can relink through the connector.