POST SecretStore/Mutate

Changes the VaultType for a vault entry. This is most commonly used to convert a vault entry to an archived vault entry.

Requirements

  • Permissions: The caller must have Master Admin permission.
  • Token scope:  Restricted:Manage

Headers

  • Content type: Content-Type:application/json.

  • Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.

Parameters

Input parameters

Name

Description

VaultID

The integer which uniquely identifies the vault entry to change.

VaultType

The new type to assign to the vault. See SecretStore Vault Type.

Returns

Upon success SecretStore/Mutate returns a HTTP 200 message. If successful, the event information appears in the Trust Protection Platform log.

Response description

Name

Description

Result

A number indicating the status:

Example Change a vault type

Request

POST https://tpp.venafi.example/vedsdk/SecretStore/Mutate
Authorization:Bearer 4MyGeneratedBearerTknz==
{
   "VaultID":1073741826,
   "VaultType":6
}

Response

HTTP/1.1 200 OK
{
   "Result":0
}