Rotate the signing secret

POST /webhook_endpoints/:id/rotate_secret

A new secret signs every delivery from now on. For 24 hours the previous secret signs too, as a second v1 in Hometown-Signature, so receivers can switch without missing an event.

Request

Responses

200
default

The endpoint, with its new secret.

Response Headers

X-Request-Id

The id of this request. Quote it when you contact support.

Hometown-Version

The API version that answered: the one the request named, or the version the account is pinned to.

RateLimit-Policy

The per-minute limit of the account, as limit;w=60.

RateLimit

Requests left in the current minute: limit, remaining and reset in seconds.

Every error is a problem details body; code says which.

HTTP	Code	When
401	`api_key_missing`	The request has no API key.
401	`api_key_invalid`	The key does not match any Hometown key.
401	`api_key_revoked`	The key was revoked and no longer works.
401	`api_key_expired`	The key was rotated and its 7-day overlap period ended.
403	`scope_missing`	The key lacks the scope this operation requires, or the operation belongs to the Records add-on, which the account does not have.
403	`tenant_suspended`	The account is pending activation or suspended, and every key of the account is refused.
403	`terms_not_accepted`	The account has not accepted the current API Terms and Data Processing Agreement, and the 30 days after they took effect are over.
403	`ip_not_allowed`	The request came from an IP address outside the allowlist of the key.
403	`api_key_paused`	The key is paused because its activity looked unlike its usual traffic.
403	`test_key_on_live_route`	This operation accepts only a live key.
404	`not_found`	No resource with this id exists in this account and environment, or the path is not part of the API.
429	`rate_limited`	The key exceeded the per-minute limit of the account.
429	`daily_quota_reached`	The account reached its daily request limit.
429	`sandbox_daily_cap_reached`	The test keys of an account make up to 200 estimates a day together, sandbox inputs included.
500	`internal_error`	The request failed inside Hometown.