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

# 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 request has succeeded.

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

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/keyvault-secrets.md) · [All operations](https://skmtc.dev/azure/apis/keyvault-secrets/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/keyvault-secrets/revisions/e4f78a39a766/schema)