Skip to Content
kosemdocs
ReferenceAPISecrets

Access secret version in organization

Reads a version's value. Every read is recorded in the Data Access audit log, whatever the organization records otherwise.

GET
/v1/organizations/{organization}/secrets/{secret}/versions/{version}/access

Reads a version's value. Every read is recorded in the Data Access audit log, whatever the organization records otherwise.

Authorization

bearer
headerAuthorizationBearer <token>

An access token, or an API key.

Path Parameters

organization*string

The organization's ID.

Match^org_[0-7][0-9a-hjkmnp-tv-z]{25}$
secret*string

The secret's ID.

Match^sec_[0-7][0-9a-hjkmnp-tv-z]{25}$
version*string

The version's number, or latest for the newest enabled one.

Match^([1-9][0-9]{0,8}|latest)$

Response Body

OK

application/json
  1. response
name*string

The version read, by its number, even when the request named latest.

payload*

Its value.

Example Request
curl -X GET 'https://api.kosem.ai/v1/organizations/string/secrets/string/versions/string/access'
Example Response
{
  "name": "string",
  "payload": {
    "data": "string"
  }
}