get_resource
Fetch a single project resource by UUID. Returns its kind, connector, the place it is bound to, title, description, switch and timestamps.
Purpose
Fetch full detail for one project resource. Results are scoped to the caller's team; unknown or out-of-scope IDs surface as RESOURCE_NOT_FOUND to prevent existence leaks.
Required ability
project-resource:view
Input schema
{
"type": "object",
"required": ["resource_id"],
"properties": {
"resource_id": {
"type": "string",
"description": "UUID of the project resource to fetch."
}
}
}Output shape
{
"data": {
"id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
"project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
"kind": "telegram:channel",
"connector": "telegram",
"space": {
"id": "3c1f7a58-2b6e-4d90-8f41-6a2e9c5d7b10",
"external_id": "-1001234567890",
"title": "Research Channel"
},
"title": "Research Channel",
"description": null,
"active": true,
"created_at": "2026-05-18T10:05:00Z",
"updated_at": "2026-05-18T10:05:00Z"
}
}kind is manual for a perk the creator hands over by hand, otherwise the connector's kind spelled connector:kind as list_connectors lists each connector's resource_kinds. connector and space are null for a manual perk; space is also null for a place-kind resource that was unlinked.
Example prompts
"Show resource
b73c5f21-9d80-4a6e-8215-4f70ce13a9d6in full."
"Which place is this resource linked to?"
Failure modes
RESOURCE_NOT_FOUND— unknownresource_id, or the parent project is outside the token's scope.TOKEN_MISSING_ABILITY— token lacksproject-resource:view.
Related
How is this guide?