Dispatch

Rotate a signing secret

POST/v1/dispatch/endpoints/:id/rotate-secret

Creates a new signing secret. The old one keeps working for a short overlap.

Parameters

Path parameters1

idstringRequired

Destination ID (dst_…).

Returns

200The sample response is on the right.Errors return error and message; see Errors and limits.

POSTRotate a signing secret

curl -X POST "https://api.getensue.com/v1/dispatch/endpoints/dst_…/rotate-secret" \
  -H "authorization: Bearer $ENSUE_API_KEY"

const res = await fetch("https://api.getensue.com/v1/dispatch/endpoints/dst_…/rotate-secret", {
  method: "POST",
  headers: {
    authorization: `Bearer ${process.env.ENSUE_API_KEY}`,
  },
});
console.log(await res.json());

import os, requests

res = requests.post(
    "https://api.getensue.com/v1/dispatch/endpoints/dst_…/rotate-secret",
    headers={"authorization": f"Bearer {os.environ['ENSUE_API_KEY']}"},
)
print(res.json())

200Response

{
  "secret": "whsec_…",
  "previous_valid_until": 1762848000000
}

{"secret":"whsec_…","previous_valid_until":1762848000000}