---
title: "POST /prebackup"
method: POST
path: "/prebackup"
---

# POST /prebackup

`POST /prebackup`

Pre-backup operation for checking whether the customer can perform a full backup operation.

## Query parameters

- `api-version` string, required

## Request body

- PreBackupOperationParameters — The authentication method and location for the backup operation.
  - `storageResourceUri` string — Azure Blob storage container Uri
  - `token` string — The SAS token pointing to an Azure Blob storage container
  - `useManagedIdentity` boolean — Indicates which authentication method should be used. If set to true, Managed HSM will use the configured user-assigned managed identity to authenticate with Azure Storage. Otherwise, a SAS token has to be specified.

## Response `202`

The request has been accepted for processing, but processing has not yet completed.

- FullBackupOperation — Full backup operation
  - `status` 'InProgress' | 'Succeeded' | 'Canceled' | 'Failed' — The status of a long-running operation.
  - `statusDetails` string — The status details of backup operation.
  - `error` Error, nullable
    - `code` string — The error code.
    - `message` string — The error message.
    - `innererror` Error — recursive
  - `startTime` integer — The start time of the backup operation in UTC
  - `endTime` integer, nullable — The end time of the backup operation in UTC
  - `jobId` string — Identifier for the full backup operation.
  - `azureStorageBlobContainerUri` string — The Azure blob storage container Uri which contains the full backup

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2025-06-01-preview) `d5ce149a3c30` — 1 info
  - endpoint added
- **2026-07-13** (2025-06-01-preview) `657f139f664a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/keyvault-administration/changes/prebackup/post.md)

---

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