delete.md

title	description	topics	contentType	useCase	v2
Delete Hook Secrets	Learn how to delete Hook Secrets using the Dashboard and Management API. Hook Secrets may also be imported and exported using the Auth0 Deploy Command-Line Interface (CLI) tool.	hooks secrets mgmt-api dashboard	how-to	extensibility-hooks	true

Delete Hook Secrets

When you no longer need Hook Secrets for a given Hook, you can delete them using either the Dashboard or Management API.

Hook Secrets may also be imported and exported using the Deploy Command-Line Interface (CLI) Extension.

• Dashboard
• Management API

Delete Hook Secrets using the Dashboard

1. Navigate to the Hooks page in the Auth0 Dashboard, and click the pencil icon next to the Hook you want to edit.

2. In the Hook editor, click the wrench icon, and click Secrets.

3. Locate the Hook Secret you want to delete, click the trash can icon, and confirm.

Delete Hook Secrets using the Management API

1. Make a DELETE call to the Delete Hook Secrets endpoint. Be sure to replace HOOK_ID, HOOK_SECRET_NAME, and MGMT_API_ACCESS_TOKEN placeholder values with your hook ID, your hook secret name(s), and Management API Access Token, respectively.

{
	"method": "DELETE",
	"url": "https://${account.namespace}/api/v2/hooks/HOOK_ID/secrets",
	"headers": [
   	{ "name": "Authorization", "value": "Bearer MGMT_API_ACCESS_TOKEN" }
	],
    "postData": {
    "mimeType": "application/json",
    "text": "{ [ \"HOOK_SECRET_NAME\", \"HOOK_SECRET_NAME\" ] }"
  }
}

Value	Description
HOOK_ID	ID of the Hook for which you want to delete secrets.
MGMT_API_ACCESS_TOKEN	Access Tokens for the Management API with the scope delete:hooks.
HOOK_SECRET_NAME	Name(s) of the secret(s) you would like to delete from the specified Hook. This endpoint accepts an array of secret names to delete.