get_entity_tasks
- Category: links
- Access: read
- Audience: ordinary (an ordinary user normally calls this directly)
Purpose
Lists every live task linked to one knowledge-graph entity. The reverse view of get_task_links, useful for seeing all work touching a person, vendor, or topic.
Arguments
Required: entity_name.
-
entity_name.
Result
JSON object with entity_name and tasks, each carrying id, title, status, priority, section, link_type, score (or null), and linked_at (or null).
Boundaries
The entity must be visible under the caller's project grants, and linked tasks are filtered to the caller's grants as well. An unknown or invisible entity answers Entity not found; an empty grant set reads as an empty task list.
Lifecycle / side effects
Pure read over live links; removed links resolve as absent.
Errors
Missing or non-string entity_name is rejected by validation. Unknown arguments are rejected (strict validator). Unlike get_task_links, an unknown name is an error, not an empty list.
Example
{
"entity_name": "Acme Print"
}
Result shape:
{
"entity_name": "Acme Print",
"tasks": [
{
"id": "<uuid>",
"link_type": "manual",
"linked_at": "<iso-8601>",
"score": null,
"status": "not_started",
"title": "Draft Paul pack README"
}
]
}
See also
get_task_links, link_task_entity, suggest_task_links, open_nodes.