archive_observations
- Category: knowledge
- Access: write
- Audience: ordinary (an ordinary user normally calls this directly)
Purpose
Archive observations. Records are preserved in history.
Arguments
Required: deletions.
-
deletions. Note: Array of entityName+observations.
Result
JSON object with archived and already_archived counts.
Boundaries
Project-scoped; misses and foreign rows read as not found.
Lifecycle / side effects
Lifecycle only, never physical DELETE.
Errors
Bad shapes rejected. Failures move nothing (atomic).
Example
{
"deletions": []
}
Result shape:
{
"archived": 1
}