---
title: "Merchant Account - KV Status"
method: POST
path: "/accounts/{account_id}/kv"
tags: ["Merchant Account"]
---

# Merchant Account - KV Status

`POST /accounts/{account_id}/kv`

## Request

- The document declares no server URL.
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/hyperswitch/apis/dynamic-routing-openapi-3-0/docs/accounts/:account_id/kv/post.ts> (a function with typed inputs; its response is checked against the schema)

Toggle KV mode for the Merchant Account

## Path parameters

- `account_id` string, required

## Request body

- ToggleKVRequest
  - `kv_enabled` boolean, required: Status of KV for the specific merchant

## Response `200`

KV mode is enabled/disabled for Merchant Account

- ToggleKVResponse
  - `merchant_id` string, required: The identifier for the Merchant Account
  - `kv_enabled` boolean, required: Status of KV for the specific merchant

## Other responses

- `400`: Invalid data
- `404`: Merchant account not found

---

[API](https://skmtc.dev/hyperswitch/apis/dynamic-routing-openapi-3-0.md) - [All operations](https://skmtc.dev/hyperswitch/apis/dynamic-routing-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/hyperswitch/apis/dynamic-routing-openapi-3-0/revisions/8fbf69ab2597?raw)