FruxonDocs
IntegrationsConfigs

Rotates the inbound webhook key for this configuration

Mints a fresh key, stamps the new id on the config, revokes the previous key. Returns the new URL exactly once. Traffic on the previous URL stops immediately — re-register the new URL with the provider before traffic resumes. Returns 400 when the integration declares per-binding ownership (rotate is per-binding for those), or when no key is currently bound (use `:generateWebhookUrl` to mint the first one).

POST
/v1/tenants/{tenant}/integrations/{integration}/configs/{config}/webhook:rotate
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

integration*string

The integration ID.

config*string

The configuration ID.

Formatuuid
tenant*string

The tenant identifier

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/integrations/string/configs/497f6eca-6276-4993-bfeb-53cbbbba6f08/webhook:rotate"
{
  "webhookUrl": "string",
  "webhookKeyPrefix": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}