external_linked
- Category: knowledge
- Access: read
- Audience: ordinary (an ordinary user normally calls this directly)
Purpose
Externals citing a target (reverse lookup).
Arguments
Required: target_kind, target_ref.
Optional: limit.
-
target_kind. Note: Required target kind. -
target_ref. Note: Required target reference. -
limit. Note: Max rows (1-200, default 50).
Result
JSON object with externals array (empty when unlinked).
Boundaries
Governed types are conductor-registered. Instances are project-scoped; misses and foreign rows read as not found. Refs stored, never fetched.
Lifecycle / side effects
Types immutable once governed. Instances and links accumulate; rows are never deleted.
Errors
Bad shapes/transitions rejected. Failures move nothing (atomic).
Example
{
"target_kind": "task",
"target_ref": "..."
}
Result shape:
{
"externals": []
}