diff options
Diffstat (limited to 'docs/openapi.yaml')
| -rw-r--r-- | docs/openapi.yaml | 17 |
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: |
