create_resource

Create a manual project resource (PDF link, token, URL placeholder). Telegram chats must be linked via the bot.

Purpose

Create a manual project resource. Delegates to an Action so policy checks and cache invalidation run identically to the dashboard, and a project.resource.created event fires.

Telegram chat / group / supergroup resources cannot be created through this tool. The bot's RequestChat flow is the only path that can persist a chat_id — the bot must prove membership + admin before the link is trusted. Create manual placeholders here and let the creator finish linking from the bot.

Required ability

project-resource:create

Input schema

{
  "type": "object",
  "required": ["project_id", "title"],
  "properties": {
    "project_id": {
      "type": "string",
      "description": "UUID of the parent project."
    },
    "title": {
      "type": "string",
      "description": "Resource title (5..255 chars)."
    },
    "description": {
      "type": "string",
      "description": "Optional resource description. Max 1000 chars, HTML is filtered."
    },
    "active": {
      "type": "boolean",
      "description": "Defaults to true. Set false to create in inactive state."
    }
  }
}

Output shape

{
  "data": {
    "id": "rsc_01HX...",
    "project_id": "prj_01HX...",
    "type": "manual",
    "title": "Onboarding PDF",
    "description": "Link to the onboarding pack.",
    "active": true
  }
}

Example prompts

"Create a manual resource titled 'Welcome packet' on project prj_01HX...."

"Add an onboarding resource to my Research Premium project."

Failure modes

VALIDATION_FAILED — title is outside the 5..255 character range.
RESOURCE_NOT_FOUND — project_id is unknown or out of the token's team scope.
TOKEN_MISSING_ABILITY — token lacks project-resource:create.