Annotations
ArcaQ feature
§1 — Four annotation types
Annotations are typed objects — not free-text black holes.
Comment
General contextual note attached to a node.
Correction
Flag an incorrect assertion for review, triggering a structured workflow.
Validation
Confirm that an assertion is verified and accurate.
Question
Mark knowledge gaps to prompt research or expert contribution.
Private or shared visibility
Annotations default to private. Mark as shared to make them visible to teammates.
Sidebar integration
Click any node to reveal its annotations panel in the Second Brain sidebar.
§2 — API reference
All annotation operations exposed via the Second Brain REST API.
| Method | Endpoint | Description |
|---|---|---|
| POST | /second-brain/annotations | Add annotation to an entity URI |
| GET | /second-brain/annotations?entity_uri=… | Get annotations for an entity |
| DELETE | /second-brain/annotations/{id} | Delete an annotation |