Permanently destroys a secret before its expiration time. Requires the receipt identifier and a passphrase if one was set. Returns the updated receipt record with burn confirmation and related URLs.
POST
/api/v2/receipt/{identifier}/burn
curl \
--request POST 'https://us.onetimesecret.com/api/v2/receipt/{identifier}/burn' \
--user "username:password" \
--header "Content-Type: application/json" \
--data '{"continue":"string"}'
Request examples
{
"continue": "string"
}
Response examples (200)
{
"user_id": "string",
"shrimp": "",
"record": {
"identifier": "string",
"created": 42.0,
"updated": 42.0,
"key": "string",
"shortid": "string",
"state": "new",
"custid": "string",
"owner_id": "string",
"shared": "string",
"previewed": "string",
"revealed": "string",
"burned": "string",
"secret_ttl": "string",
"receipt_ttl": "string",
"lifespan": "string",
"secret_shortid": "string",
"secret_identifier": "string",
"recipients": [
"string"
],
"share_domain": "string",
"has_passphrase": true,
"is_previewed": "string",
"is_revealed": "string",
"is_burned": "string",
"is_destroyed": "string",
"is_expired": "string",
"is_orphaned": "string",
"memo": "string",
"kind": "generate",
"received": "string",
"viewed": "string",
"is_viewed": "string",
"is_received": "string",
"secret_state": "new",
"natural_expiration": "string",
"expiration_in_seconds": "string",
"share_path": "string",
"burn_path": "string",
"receipt_path": "string",
"share_url": "string",
"receipt_url": "string",
"burn_url": "string",
"expiration": 42.0
},
"details": {
"type": "record",
"display_lines": "string",
"no_cache": "string",
"secret_realttl": 42.0,
"view_count": "string",
"has_passphrase": "string",
"can_decrypt": "string",
"secret_value": "string",
"show_secret": "string",
"show_secret_link": "string",
"show_receipt_link": "string",
"show_receipt": "string",
"show_recipients": "string",
"is_orphaned": "string",
"is_expired": "string"
}
}
Response examples (400)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}
Response examples (401)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}
Response examples (403)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}
Response examples (404)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}
Response examples (422)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}
Response examples (500)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}