Skip to content

Get Kvs V2

GET
/config/v2/kv

Get All KVs and Secret KVs. Regular KVs are always returned.

Required permissions for secret KVs: : config:secret_kvs:read

Authorizations

Parameters

Query Parameters

keys_to_include
Any of:
Array<string>

If specified, will only return the KVs with the specified keys

Header Parameters

if-none-match
Any of:
string

If you provide the ETag that matches the current ETag for this content, will return a 304 response - indicating that the content has not changed.

if-match
Any of:
string

If you provide the ETag that matches the current ETag for this content, will return a 412 response - indicating that the content has changed.

Responses

200

Successful Response

object
kvs

The list of key/value pairs

object
key
additional properties
string
secret_kvs

DEPRECATED The list of permissioned key/value pairs

object
key
additional properties
string
kick_before_hint
Any of:

Datetime that enforces that a timezone is given. Unix timestamps are allowed and forced into the UTC time zone

string format: date-time
2023-01-23T21:07:02.000000+00:00

Headers

ETag
string

Used to identify this version of the content. Provide with a get request to avoid downloading the same data multiple times.

304

Content still has the same etag and has not changed

412

Content has changed since the ETag was provided

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string