API reference
POST /v1/webhooks/{id}/rotate-secret
Issue a new signing secret
Issue a new signing secret
The new secret is shown once; the old one stops working immediately. Requires scope write:deals.
- Authentication: header
Authorization: Bearer rv_live_...(API keys and scopes) - Required scope:
write:deals
Descriptions of the operation, parameters and fields come from the OpenAPI specification (
openapi.json).Parameters
| Field | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string (uuid) | yes | Resource id (UUID). |
Responses
200
The new secret.
application/json · Schema: WebhookSecret
| Field | Type | Required | Description |
|---|---|---|---|
secret | string | yes | New signing secret, shown once. The previous secret stops working immediately. |
400
Invalid request parameters or body (code validation_error).
application/problem+json · Schema: Problem
401
Missing, malformed, unknown, revoked or expired API key (code unauthorized).
application/problem+json · Schema: Problem
403
The API key lacks the scope required by this endpoint (code insufficient_scope).
application/problem+json · Schema: Problem
404
Not found in this tenant.
application/problem+json · Schema: Problem
429
Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.
application/problem+json · Schema: Problem