aboutsummaryrefslogtreecommitdiffstats
path: root/docs/openapi.yaml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/openapi.yaml')
-rw-r--r--docs/openapi.yaml9
1 files changed, 5 insertions, 4 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 1b4a199..5728da5 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -110,7 +110,7 @@ paths:
- $ref: '#/components/parameters/at'
- name: raw
in: query
- description: Values their users signed as stored, as envelopes (`cv1.<payload>.<signature>`), to check them.
+ description: Values their users signed as stored, as envelopes (`cv2.<value>.<meta>.<signature>`), to check them.
schema:
type: boolean
default: false
@@ -158,8 +158,8 @@ paths:
`application/vnd.continuum.timestamp; format=rfc3339|unix|unix-ms|http-date`;
a body that isn't one is `400`, saying why.
- A value its user signed (`application/continuum-signed`: the payload's line of
- JSON, then its armored SSH signature; `api.md`, Signed values) is written as its
+ A value its user signed (`application/continuum-signed`: the value's line of
+ JSON, the meta's, then the armored SSH signature of both; `api.md`, Signed values) is written as its
envelope where values are signed: by the authenticated user, for this path,
with one of its keys, replacing what is there. A signed `null` deletes (`204`).
parameters:
@@ -192,7 +192,8 @@ paths:
schema:
type: string
example: |
- {"swarm":"6f9a…","path":["config"],"value":{"mode":"fast"},"user":"alice","at":1762400000000,"prev":""}
+ {"mode":"fast"}
+ {"swarm":"6f9a…","path":["config"],"user":"alice","at":1762400000000,"seq":0,"prev":""}
-----BEGIN SSH SIGNATURE-----
U1NIU0lH…
-----END SSH SIGNATURE-----