---
title: "POST /v1/{+name}:destroy"
method: POST
path: "/v1/{+name}:destroy"
tags: ["projects"]
---

# POST /v1/{+name}:destroy

`POST /v1/{+name}:destroy`

Destroys a SecretVersion. Sets the state of the SecretVersion to DESTROYED and irrevocably destroys the secret data.

## Path parameters

- `name` string, required

## Request body

- DestroySecretVersionRequest — Request message for SecretManagerService.DestroySecretVersion.
  - `etag` string — Optional. Etag of the SecretVersion. The request succeeds if it matches the etag of the currently stored secret version object. If the etag is omitted, the request succeeds.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/secretmanager.md) · [All operations](https://skmtc.dev/google/apis/secretmanager/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/secretmanager/revisions/7d97d4a1afab/schema)