---
title: "Rename a dynamic QR vault"
method: PATCH
path: "/api/dynamic-qr-vaults/{vaultId}"
---

# Rename a dynamic QR vault

`PATCH /api/dynamic-qr-vaults/{vaultId}`

Requires the current vault ETag in If-Match or X-Dynamic-QR-Vault-Version.

## Headers

- `If-Match` string, required
- `X-Dynamic-QR-Vault-Version` string

## Request body

- DynamicQrVaultRenameRequest
  - `name` string, required

## Response `200`

Renamed vault

- DynamicQrVaultResponse
  - `success` boolean, required
  - `vault` DynamicQrVaultRecord, required — Public authorized representation. Never contains managementTokenHash, qrSlugs, child credentials, or internal storage fields.
    - `vaultId` string, required
    - `name` string, required
    - `version` integer, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `emptyExpiresAt` string, date-time, nullable, required — Empty projects expire after six hours. This is null once the project contains a QR code.
    - `records` DynamicQrVaultChildRecord[], required
      - `slug` string, required
      - `destination` string, uri, required
      - `label` string, required
      - `status` 'active' | 'paused', required
      - `version` integer, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `folder` string
      - `tags` string[]

## Other responses

- `401` — Invalid vault capability
- `412` — Missing or stale vault ETag

---

[API](https://skmtc.net/qrcodecrafter/apis/qrcodecrafter-api-2.md) · [All operations](https://skmtc.net/qrcodecrafter/apis/qrcodecrafter-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qrcodecrafter/qrcodecrafter-api-2/revisions/87cd2664770b/schema)