aboutsummaryrefslogtreecommitdiffstats
path: root/docs/openapi.yaml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/openapi.yaml')
-rw-r--r--docs/openapi.yaml34
1 files changed, 33 insertions, 1 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index de62b59..bb017f0 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1643,6 +1643,30 @@ paths:
'503':
$ref: '#/components/responses/Error'
+ /admin/strict-manifest:
+ get:
+ tags: [Remakes]
+ summary: A manifest turning the swarm strict
+ description: 'Keeping every value at the places values are signed as it is now (by its digest), with the policy and `"values": "signed"`, for the caller to look over, sign (`ssh-keygen -Y sign -n continuum-strict`) and propose as a `strict` remake at `heads` (`baseHeads`). Needs reading `_continuum`.'
+ responses:
+ '200':
+ description: The manifest's line, the values it keeps, the heads they are at.
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ manifest: { type: string }
+ values:
+ type: array
+ items:
+ type: object
+ properties:
+ path: { type: array, items: { type: string } }
+ value: {}
+ heads: { type: array, items: { type: string } }
+ namespace: { type: string }
+
/admin/epochs:
get:
tags: [Remakes]
@@ -2878,16 +2902,24 @@ components:
properties:
kind:
type: string
- enum: [compact, replace, import]
+ enum: [compact, replace, import, strict]
default: compact
spec:
description: |
`compact`: none. `replace`: `{document: <store root object>, rules}`.
`import`: `{document: <base64 of an Automerge document>, rules}`; its
`_continuum` and history are left out, Automerge types are kept.
+ `strict`: `{manifest: "<its line>\n<its signature>"}`, as
+ `GET /admin/strict-manifest` gives the line, signed by a key of
+ `--strict-keys` (`403` from a node that takes no such manifest).
oneOf:
- type: 'null'
- type: object
+ required: [manifest]
+ additionalProperties: false
+ properties:
+ manifest: { type: string }
+ - type: object
required: [document]
additionalProperties: false
properties: