Rotate the HMAC signing secret for the registered webhook.

POST

/v1/webhook/secret/rotate

Generates a new HMAC-SHA256 secret for the authenticated account's webhook. The new secret replaces the previous one immediately. Store the returned secret securely — it cannot be retrieved again.

Required scope: webhooks:write

Request

None

Responses

🟢200

application/json

Secret rotated successfully.

Bodyapplication/json

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://dev.api.fieldedge.com/open-api/v1/webhook/secret/rotate'

Response Example

200 - response

{
    "data": {
        "webhookId": "9b8df6c2-fc64-4be6-a187-cde2b27cb515",
        "secret": "K7yI1jZq3+UqZtXhY=bH0rN+4bD5zQp7TtX6sSgV6uX9"
    }
}

Modified at 2026-07-01 10:25:15

Delete the registered webhook for the authenticated account.