Dashboard

Webhooks

Promote signing key

Make a secondary key the primary. The previous primary is retired at once, so update your receiver to the new secret first.

POSThttps://api.sndr.sh/v1/webhooks/{id}/signing-keys/{key_id}/promote
Promote signing key
curl -X POST 'https://api.sndr.sh/v1/webhooks/wh_2a7d4e9c-6b1/signing-keys/whk_61d0a9c7-5e4/promote' \
  -H "Authorization: Bearer $SNDR_API_KEY"
200OK
{
  "id":     "whk_61d0a9c7-5e4",
  "status": "primary"
}

Authorization

Authorizationstringheaderrequired

Bearer followed by your API key. Needs the send scope.

Path parameters

idstringrequired

Webhook ID (wh_...).

key_idstringrequired

Secondary key ID (whk_...) from the stage call.

Errors

401unauthenticatedMissing or invalid API key.
403insufficient_scopeThe API key is missing the send scope.
404not_foundResource does not exist or belongs to a different account.
409conflictThe key is not a secondary key.