From 491751e51a554d991d5066dbe968aa44f3d66f30 Mon Sep 17 00:00:00 2001 From: tv Date: Mon, 16 Nov 2026 21:46:03 +0000 Subject: api: what the store refused, by kind `GET /events/refused` says of each refusal its kind (`none`, `judged`, `builtOn`, with the event it builds on, or `notAbove`), apart from why: a party's client signs again what a move refused, which it tells so. --- docs/openapi.yaml | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/openapi.yaml b/docs/openapi.yaml index c8f839c..1bb69e3 100644 --- a/docs/openapi.yaml +++ b/docs/openapi.yaml @@ -1555,7 +1555,9 @@ paths: 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 - `refused`, every other, with why. + `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. responses: '200': description: What it refused. @@ -1577,10 +1579,15 @@ paths: type: array items: type: object - required: [id, why] + required: [id, kind, why] properties: id: type: string + kind: + type: string + enum: [none, judged, builtOn, notAbove] + on: + type: string why: type: string '404': -- cgit v1.3.1