Skip to content

Commit 1a51160

Browse files
authored
CBG-4369 add missing API docs (#7204)
1 parent 4d63f7c commit 1a51160

File tree

8 files changed

+20
-0
lines changed

8 files changed

+20
-0
lines changed

docs/api/components/parameters.yaml

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -385,6 +385,13 @@ show_exp:
385385
schema:
386386
type: boolean
387387
description: Whether to show the expiry property (`_exp`) in the response.
388+
show_cv:
389+
name: show_cv
390+
in: query
391+
required: false
392+
schema:
393+
type: boolean
394+
description: Output the current version of the version vector in the response as property `_cv`.
388395
startkey:
389396
name: startkey
390397
in: query

docs/api/components/responses.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -138,6 +138,8 @@ all-docs:
138138
properties:
139139
rev:
140140
type: string
141+
cv:
142+
type: string
141143
uniqueItems: true
142144
total_rows:
143145
type: number

docs/api/paths/admin/keyspace-_all_docs.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ get:
2626
- $ref: ../../components/parameters.yaml#/startkey
2727
- $ref: ../../components/parameters.yaml#/endkey
2828
- $ref: ../../components/parameters.yaml#/limit-result-rows
29+
- $ref: ../../components/parameters.yaml#/show_cv
2930
responses:
3031
'200':
3132
$ref: ../../components/responses.yaml#/all-docs

docs/api/paths/admin/keyspace-_bulk_get.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ post:
4545
description: If this header includes `gzip` then the the HTTP response will be compressed. This takes priority over `X-Accept-Part-Encoding`. Only part compression will be done if `X-Accept-Part-Encoding=gzip` and the `User-Agent` is below 1.2 due to clients not being able to handle full compression.
4646
schema:
4747
type: string
48+
- $ref: ../../components/parameters.yaml#/show_cv
4849
requestBody:
4950
content:
5051
application/json:

docs/api/paths/admin/keyspace-docid.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ get:
2121
- $ref: ../../components/parameters.yaml#/rev
2222
- $ref: ../../components/parameters.yaml#/open_revs
2323
- $ref: ../../components/parameters.yaml#/show_exp
24+
- $ref: ../../components/parameters.yaml#/show_cv
2425
- $ref: ../../components/parameters.yaml#/revs_from
2526
- $ref: ../../components/parameters.yaml#/atts_since
2627
- $ref: ../../components/parameters.yaml#/revs_limit
@@ -52,6 +53,7 @@ get:
5253
- Bob
5354
_id: AliceSettings
5455
_rev: 1-64d4a1f179db5c1848fe52967b47c166
56+
_cv: 1@src
5557
'400':
5658
$ref: ../../components/responses.yaml#/invalid-doc-id
5759
'404':

docs/api/paths/public/keyspace-_all_docs.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ get:
2020
- $ref: ../../components/parameters.yaml#/startkey
2121
- $ref: ../../components/parameters.yaml#/endkey
2222
- $ref: ../../components/parameters.yaml#/limit-result-rows
23+
- $ref: ../../components/parameters.yaml#/show_cv
2324
responses:
2425
'200':
2526
$ref: ../../components/responses.yaml#/all-docs

docs/api/paths/public/keyspace-_bulk_get.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ post:
4040
description: If this header includes `gzip` then the the HTTP response will be compressed. This takes priority over `X-Accept-Part-Encoding`. Only part compression will be done if `X-Accept-Part-Encoding=gzip` and the `User-Agent` is below 1.2 due to clients not being able to handle full compression.
4141
schema:
4242
type: string
43+
- $ref: ../../components/parameters.yaml#/show_cv
4344
requestBody:
4445
content:
4546
application/json:

docs/api/paths/public/keyspace-docid.yaml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ get:
1515
- $ref: ../../components/parameters.yaml#/rev
1616
- $ref: ../../components/parameters.yaml#/open_revs
1717
- $ref: ../../components/parameters.yaml#/show_exp
18+
- $ref: ../../components/parameters.yaml#/show_cv
1819
- $ref: ../../components/parameters.yaml#/revs_from
1920
- $ref: ../../components/parameters.yaml#/atts_since
2021
- $ref: ../../components/parameters.yaml#/revs_limit
@@ -39,13 +40,17 @@ get:
3940
_rev:
4041
description: The revision ID of the document.
4142
type: string
43+
_cv:
44+
description: The current version of version vector of the document.
45+
type: string
4246
additionalProperties: true
4347
example:
4448
FailedLoginAttempts: 5
4549
Friends:
4650
- Bob
4751
_id: AliceSettings
4852
_rev: 1-64d4a1f179db5c1848fe52967b47c166
53+
_cv: 1@src
4954
'400':
5055
$ref: ../../components/responses.yaml#/invalid-doc-id
5156
'404':

0 commit comments

Comments
 (0)