# Burn Secret

**POST /api/v1/private/{key}/burn**




## Servers
- Aotearoa New Zealand: https://nz.onetimesecret.com (Aotearoa New Zealand)
- Canada: https://ca.onetimesecret.com (Canada)
- Europe: https://eu.onetimesecret.com (Europe)
- United Kingdom: https://uk.onetimesecret.com (United Kingdom)
- United States: https://us.onetimesecret.com (United States)
- Development: http://localhost:3000 (Development)


## Authentication methods
- Basic auth


## Parameters

### Path parameters

- **key** (string)
  The key parameter



### Body: application/x-www-form-urlencoded (object)

- **continue** (boolean | string)

- **passphrase** (string)



## Responses
### 200
Successful response

#### Body: application/json (object)
- **state** (object)

- **secret_shortkey** (string)


### 400
Bad Request - Invalid request parameters or body

#### Body: application/json (object)
- **error** (string)
  ADR-013: user-facing message (V2+). On frozen V1 this is the error type identifier.

- **error_type** (string)
  Machine-readable error class the client branches on (ADR-013, e.g., "RecordNotFound")

- **message** (string)
  Human-readable error message (legacy/V1 shape)

- **field** (string)
  Field that caused the error, if applicable

- **error_id** (string)
  Unique error tracking identifier

- **request_id** (string)
  Request correlation id; mirrors the x-request-id response header and appears in the server request log. Quote this when reporting an error.


### 401
Unauthorized - Authentication required

#### Body: application/json (object)
- **error** (string)
  ADR-013: user-facing message (V2+). On frozen V1 this is the error type identifier.

- **error_type** (string)
  Machine-readable error class the client branches on (ADR-013, e.g., "RecordNotFound")

- **message** (string)
  Human-readable error message (legacy/V1 shape)

- **field** (string)
  Field that caused the error, if applicable

- **error_id** (string)
  Unique error tracking identifier

- **request_id** (string)
  Request correlation id; mirrors the x-request-id response header and appears in the server request log. Quote this when reporting an error.


### 403
Forbidden - Insufficient permissions

#### Body: application/json (object)
- **error** (string)
  ADR-013: user-facing message (V2+). On frozen V1 this is the error type identifier.

- **error_type** (string)
  Machine-readable error class the client branches on (ADR-013, e.g., "RecordNotFound")

- **message** (string)
  Human-readable error message (legacy/V1 shape)

- **field** (string)
  Field that caused the error, if applicable

- **error_id** (string)
  Unique error tracking identifier

- **request_id** (string)
  Request correlation id; mirrors the x-request-id response header and appears in the server request log. Quote this when reporting an error.


### 404
Not Found - Resource does not exist

#### Body: application/json (object)
- **error** (string)
  ADR-013: user-facing message (V2+). On frozen V1 this is the error type identifier.

- **error_type** (string)
  Machine-readable error class the client branches on (ADR-013, e.g., "RecordNotFound")

- **message** (string)
  Human-readable error message (legacy/V1 shape)

- **field** (string)
  Field that caused the error, if applicable

- **error_id** (string)
  Unique error tracking identifier

- **request_id** (string)
  Request correlation id; mirrors the x-request-id response header and appears in the server request log. Quote this when reporting an error.


### 422
Unprocessable Entity - Validation failed

#### Body: application/json (object)
- **error** (string)
  ADR-013: user-facing message (V2+). On frozen V1 this is the error type identifier.

- **error_type** (string)
  Machine-readable error class the client branches on (ADR-013, e.g., "RecordNotFound")

- **message** (string)
  Human-readable error message (legacy/V1 shape)

- **field** (string)
  Field that caused the error, if applicable

- **error_id** (string)
  Unique error tracking identifier

- **request_id** (string)
  Request correlation id; mirrors the x-request-id response header and appears in the server request log. Quote this when reporting an error.


### 500
Internal Server Error - Something went wrong

#### Body: application/json (object)
- **error** (string)
  ADR-013: user-facing message (V2+). On frozen V1 this is the error type identifier.

- **error_type** (string)
  Machine-readable error class the client branches on (ADR-013, e.g., "RecordNotFound")

- **message** (string)
  Human-readable error message (legacy/V1 shape)

- **field** (string)
  Field that caused the error, if applicable

- **error_id** (string)
  Unique error tracking identifier

- **request_id** (string)
  Request correlation id; mirrors the x-request-id response header and appears in the server request log. Quote this when reporting an error.



[Powered by Bump.sh](https://bump.sh)
