request_resource_link

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

Purpose

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.

Required ability

project-resource:create

Input schema

{
    "type": "object",
    "required": [
        "project_id",
        "kind"
    ],
    "properties": {
        "project_id": {
            "type": "string",
            "description": "UUID of the project the linked place will belong to."
        },
        "kind": {
            "type": "string",
            "description": "The kind of place to ask for, spelled `connector:kind` as `list_connectors` lists each connector's `resource_kinds` (`telegram:channel`, `telegram:group`, `telegram:supergroup`)."
        }
    }
}

Output shape

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

Example prompts

"Ask me to pick a new Telegram channel for the Signals project."

"Start linking a group to Ella's Kitchen."

Failure modes

CONNECTOR_NOT_INSTALLED — the project runs no connected connector, so nothing could finish the link.
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 cannot be reached on the connector.
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.

create_resource — a manual perk, created outright.
list_connectors — the resource_kinds a connector gates, the values kind takes.
list_resources — the resource appears here once the creator picks.
project.resource.linked — fires when the creator picks.
Resources API