unlink_resource

Clear the Telegram chat_id from a resource, reverting it to an unlinked placeholder the creator can relink from the bot.

Purpose

Clear the Telegram chat_id from a resource, reverting it to an unlinked placeholder row the creator can relink from the bot. 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",
    "type": "channel",
    "title": "Research Channel",
    "chat_id": null,
    "active": true
  }
}

Example prompts

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

"Break the chat 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.