Rotate the signing secret
post
https://api.flactrum.com/v1/webhooks/{webhook}/rotate-secret
Issues a new secret and returns it once. The old one stops verifying immediately.
| Required scope | webhooks.write |
| Success status | 200 |
| Returns | One Webhook object |
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| webhook * | path | string | ULID of the record. |
Response fields
| Field | Type | Description |
|---|---|---|
| id | string | — |
| name | string | — |
| url | string | — |
| scope | string | — |
| branch_id | string|null | — |
| region | string|null | — |
| is_active | boolean | — |
| events | array | — |
| failure_count | integer | Consecutive failures. Editing the endpoint resets it. |
| last_delivered_at | string|null | — |
| last_error | string|null | — |
| secret | string | Only present in the create and rotate responses. Stored encrypted; never returned again. |
Examples
No recorded example yet.