unlink_task_entity

Category: links
Access: write
Audience: ordinary (an ordinary user normally calls this directly)

Purpose

Removes a task-entity link while keeping the removal itself as durable evidence. Removing a silent high-confidence link additionally records an explicit human rejection, so the pair stays suppressed and becomes a real evaluation label.

Arguments

Required: task_id, entity_name.

task_id.
entity_name.

Result

JSON object with removed (boolean). Removing a silent high-confidence link instead returns removed true with decision_recorded rejected and the decision_id. A missing link or an invisible task returns removed false, not an error.

Boundaries

The entity must be visible under the caller's project grants or the call answers Entity not found. An invisible task reads as removed false so task existence never leaks.

Lifecycle / side effects

Marks the link removed with removal stamps and preserves a removal marker carrying the prior link detail; re-linking later revives the edge and clears the marker with its own stamps. A rejected auto-discovered link cannot resurface silently. Nothing is ever physically removed.

Errors

Missing task_id or entity_name is rejected by validation. Unknown arguments are rejected (strict validator). An unknown or out-of-scope entity answers Entity not found.

Example

{
  "entity_name": "Acme Print",
  "task_id": "<uuid>"
}

Result shape:

{
  "removed": true
}