restore_observations

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

Purpose

Restore archived observations.

Arguments

Required: deletions.

deletions. Note: Array of {entityName, observations[]} identifying rows to restore.

Result

JSON object with restored and already_active counts.

Boundaries

Only addressed rows visible under the caller's project grants are touched; missing or foreign rows are silently skipped. No cascades either direction.

Lifecycle / side effects

Void-to-active revival in place (same id, no duplicates) through the canonical mutation path with ledger events.

Errors

Malformed arguments are rejected. Failures move nothing (atomic).

Example

{
  "deletions": [
    {
      "entityName": "name",
      "observations": [
        "obs"
      ]
    }
  ]
}

Result shape:

{
  "already_active": 0,
  "restored": 1
}