Skip to content
SHAMPOO

Tool catalogue

get_entity_tasks

Read · Ordinary · Links

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.

On this page