unlink_resource

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

Purpose

Clear the connector place (space) from a resource, reverting it to an unlinked placeholder row the creator can relink through the connector with request_resource_link. Delegates to an Action so a project.resource.unlinked event fires. No-op if the resource is already unlinked.

Required ability

project-resource:update

Input schema

{
  "type": "object",
  "required": ["resource_id"],
  "properties": {
    "resource_id": {
      "type": "string",
      "description": "UUID of the resource to unlink."
    }
  }
}

Output shape

{
  "data": {
    "id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "kind": "telegram:channel",
    "connector": "telegram",
    "space": null,
    "title": "Research Channel",
    "description": null,
    "active": true,
    "created_at": "2026-05-18T10:05:00Z",
    "updated_at": "2026-09-06T08:30:12Z"
  }
}

The full get_resource row with space cleared. The resource keeps its kind and connector: it is still a Telegram channel resource, only one bound to no place until the creator links another.

Example prompts

"Unlink the Telegram channel from resource b73c5f21-9d80-4a6e-8215-4f70ce13a9d6."

"Break the place link so I can re-attach a different channel."

Failure modes

RESOURCE_NOT_FOUND — unknown resource_id, or the parent project is outside the token's scope.
TOKEN_MISSING_ABILITY — token lacks project-resource:update.

get_resource
list_resources
request_resource_link — link another place afterwards.
delete_resource
Resources API