aboutsummaryrefslogtreecommitdiffstats
path: root/docs/openapi.yaml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/openapi.yaml')
-rw-r--r--docs/openapi.yaml17
1 files changed, 10 insertions, 7 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 2017f15..3dbcd62 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1576,7 +1576,8 @@ paths:
description: |
The events the store refused: `own`, those its history takes but this node
doesn't, by what it took before (a version changing another than the one it
- reads), apart from the rest; `dropped`, those its operator had it drop; and
+ reads), apart from the rest; `dropped`, those its operator had it drop, and
+ version events naming a version among them; and
`refused`, every other, with its kind (`none`: none of the federation's events;
`judged`: refused at its history; `builtOn`: built on `on`, refused;
`notAbove`: not above the checkpoint's heads, as a move refuses it) and why.
@@ -1679,11 +1680,12 @@ paths:
tags: [Events]
summary: Drop events this node took
description: |
- Drops events the store took after its checkpoint, with everything built on
- them: this node refuses them from then on, from whoever brings them, and keeps
- so across restarts (`--store-file`), until it is told otherwise
- (`/admin/events/allow`). Not what the checkpoint keeps or holds by ID. Answers
- what it dropped, in the order taken. Needs `write` on `_continuum`.
+ Drops events the store took after its checkpoint, version events naming the
+ version one of them names, and everything built on them: this node refuses them
+ from then on, from whoever brings them, and any version event naming a version
+ among them, and keeps so across restarts (`--store-file`), until it is told
+ otherwise (`/admin/events/allow`). Not what the checkpoint keeps or holds by
+ ID. Answers what it dropped, in the order taken. Needs `write` on `_continuum`.
requestBody:
required: true
content:
@@ -1715,7 +1717,8 @@ paths:
summary: Take back what this node refused of its own, or dropped
description: |
Takes back what this node refused of its own, or dropped, among the events
- named, and what was refused for building on them: they are taken again where the
+ named, the version events dropped for naming the version one of them names, and
+ what was refused for building on them: they are taken again where the
store takes them, as it reads its document again. Needs `write` on
`_continuum`.
requestBody: