• Vault

personal secrets

get/vault/api/v1/user/{user_id}/secrets

Get secrets client owns.

offsetint

Offset where to start fetching the items

Default
0
limitint

Number of items to return

Default
100
Max
100

Responses

Response examples

Successful response, returns an array of secrets, returns an empty array if no secrets found

{
  "count": 123,
  "items": [
    {
      "name": "string",
      "data": {},
      "read_roles": [
        {
          "id": "string",
          "name": "string",
          "deleted": true
        }
      ],
      "write_roles": [
        {
          "id": "string",
          "name": "string",
          "deleted": true
        }
      ],
      "author": "string",
      "path": "string",
      "updated_by": "string",
      "created": "string",
      "updated": "string"
    }
  ]
}
post/vault/api/v1/user/{user_id}/secrets

Create a secret.

namestring

required

A unique personal secret name.

dataobject

required

A secret to be stored.

read_rolesarray

List of roles that can read a secret.

idstring

required

Role ID

namestring

Role name, ignored by server in requests.

write_rolesarray

List of roles that can replace a secret.

idstring

required

Role ID

namestring

Role name, ignored by server in requests.

owner_idstring

ID of the user who owns this secret.

Responses

Request examples

{
  "name": "string",
  "data": {},
  "read_roles": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "write_roles": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "owner_id": "string"
}

Response examples

Secret successfully created

{
  "name": "string"
}
get/vault/api/v1/user/{user_id}/secrets/{name}

Get a secret.

namestring

required

Secret name

user_idstring

required

User ID of the user who owns the secret

Responses

Response examples

Successful response, returns a secret object

{
  "name": "string",
  "data": {},
  "read_roles": [
    {
      "id": "string",
      "name": "string",
      "deleted": true
    }
  ],
  "write_roles": [
    {
      "id": "string",
      "name": "string",
      "deleted": true
    }
  ],
  "author": "string",
  "path": "string",
  "updated_by": "string",
  "created": "string",
  "updated": "string"
}
put/vault/api/v1/user/{user_id}/secrets/{name}

Update a secret.

dataobject

Secret to be stored.

read_rolesarray

List of roles that can read secret.

idstring

required

Role ID

namestring

Role name, ignored by server in requests.

write_rolesarray

List of roles that can replace secret.

idstring

required

Role ID

namestring

Role name, ignored by server in requests.

Responses

Request examples

{
  "data": {},
  "read_roles": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "write_roles": [
    {
      "id": "string",
      "name": "string"
    }
  ]
}

Response examples

Secret successfully updated

Empty response

delete/vault/api/v1/user/{user_id}/secrets/{name}

Delete a secret.

namestring

required

Secret name

user_idstring

required

User ID of the user who owns the secret

Responses

Response examples

Secret successfully deleted

Empty response

Was this page helpful?