Destroy secret versions

POST

/secret-store/secrets/:secret_id/destroy

Irreversibly destroys specified secret versions. Requires scope: secret-store.write.

Authentication

AuthorizationBearer

IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.

Path parameters

secret_idstringRequired

Secret ID.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

Request

This endpoint expects an object.

versionslist of integersRequired

Secret versions to restore or irreversibly destroy.

Response

Secret versions permanently destroyed.

statusenum

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl -X POST "https://api.ibee.ai/v1/secret-store/secrets/019f1e4b-4a2c-71d0-a8b3-c5f92e7d1a4b/destroy?workspace_id=710995" \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"versions": [
>	1
>	]
>	}'