Skip to content

Hookestdocs Postman OpenAPI llms.txt

POST/v1/webhooks/rotate0 credits

Rotate webhook secret

Issue a new whsec_…. Shown once. Previous secret stops verifying new deliveries. No webhook configured is 404.

Needs predict:write on the key. This is a permission on the key, not a request header. Missing it returns 403 api_not_enabled.

Request parameters

No query, path, or JSON body parameters.

Response

{
  "object": "webhook",
  "url": "https://customer.example/hookest",
  "configured": true,
  "secret": "whsec_…"
}

Response fields

Name	Type	Required	Description
`object`	string	Required	Always `webhook`.
`url`	string	Nullable	Configured HTTPS URL, or `null` when none is set.
`configured`	boolean	Required	True only when an HTTPS URL is active.
`secret`	string	Required	New `whsec_…`. Shown once. Previous secret stops verifying new deliveries.

hookest — zsh

curl https://api.hookest.com/v1/webhooks/rotate \
  -X POST \
  -H "Authorization: Bearer hk_live_YOUR_KEY"

const res = await fetch("https://api.hookest.com/v1/webhooks/rotate", {
  method: "POST",
  headers: {
    Authorization: "Bearer hk_live_YOUR_KEY",
  },
});
const data = await res.json();

import requests

res = requests.post(
    "https://api.hookest.com/v1/webhooks/rotate",
    headers={"Authorization": "Bearer hk_live_YOUR_KEY"},
)
data = res.json()

$ch = curl_init("https://api.hookest.com/v1/webhooks/rotate");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer hk_live_YOUR_KEY",
  ],
]);
$data = json_decode(curl_exec($ch), true);

package main

import (
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.hookest.com/v1/webhooks/rotate", nil)
  req.Header.Set("Authorization", "Bearer hk_live_YOUR_KEY")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
}