---
title: "Configures settings for the KV store"
method: POST
path: "/secret/metadata/{path}"
tags: ["secrets"]
---

# Configures settings for the KV store

`POST /secret/metadata/{path}`

## Request body

- KvMetadataRequest
  - `cas_required` boolean — If true the key will require the cas parameter to be set on all write requests. If false, the backend’s configuration will be used.
  - `custom_metadata` object — User-provided key-value pairs that are used to describe arbitrary and version-agnostic information about a secret.
  - `delete_version_after` integer — The length of time before a version is deleted. If not set, the backend's configured delete_version_after is used. Cannot be greater than the backend's delete_version_after. A zero duration clears the current setting. A negative duration will cause an error.
  - `max_versions` integer — The number of versions to keep. If not set, the backend’s configured max version is used.

## Response `200`

OK

---

[API](https://skmtc.net/lensesio/apis/hashicorp-vault-api.md) · [All operations](https://skmtc.net/lensesio/apis/hashicorp-vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lensesio/hashicorp-vault-api/revisions/bd8194de0697/schema)