Sign in

v8

latestSwagger 2.02026-07-13121636.1 KB

Sets a secret in a specified key vault.

The SET operation adds a secret to the Azure Key Vault. If the named secret already exists, Azure Key Vault creates a new version of that secret. This operation requires the secrets/set permission.

put/secrets/{secret-name}

Path parameters

secret-namestring required

The name of the secret. The value you provide may be copied globally for the purpose of running the service. The value provided should not include personally identifiable or sensitive information.

Query parameters

api-versionstring required

The API version to use for this operation.

Request body

valuestring required

The value of the secret.

tagsobject

Application specific metadata in the form of key-value pairs.

contentTypestring

Type of the secret value such as a password.

Response

The request has succeeded.

valuestring

The secret value.

idstring

The secret id.

contentTypestring

The content type of the secret.

tagsobject

Application specific metadata in the form of key-value pairs.

kidstring

If this is a secret backing a KV certificate, then this field specifies the corresponding key backing the KV certificate.

managedboolean

True if the secret's lifetime is managed by key vault. If this is a secret backing a certificate, then managed will be true.