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