---
title: "Backs up the specified secret."
method: POST
path: "/secrets/{secret-name}/backup"
tags: ["Secrets"]
---

# Backs up the specified secret.

`POST /secrets/{secret-name}/backup`

Requests that a backup of the specified secret be downloaded to the client. All versions of the secret will be downloaded. This operation requires the secrets/backup permission.

## Path parameters

- `secret-name` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The backup blob containing the backed up secret.

- BackupSecretResult — The backup secret result, containing the backup blob.
  - `value` string, base64url — The backup blob containing the backed up secret.

## Other responses

- `default` — Key Vault error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/keyvaultclient.md) · [All operations](https://skmtc.net/azure/apis/keyvaultclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/keyvaultclient/revisions/1f612999ec40/schema)