FruxonDocs
IntegrationsConfigs

Asks the provider what webhook URL it currently has registered for this config and whether recent deliveries have been failing.

Inspects the provider's registered webhook and delivery health. Telegram reports its registered URL, last_error_message and pending_update_count. Returns 400 for providers that do not support inspection.

POST
/v1/tenants/{tenant}/integrations/{integration}/configs/{config}:inspectWebhook

Authorization

Bearer
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

Request Body

Optional expected URL for drift detection.

expectedWebhookUrl?string|null

The URL Fruxon previously minted, for drift detection. Null when the FE doesn't have the URL in memory (e.g. fresh page load).

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/integrations/string/configs/497f6eca-6276-4993-bfeb-53cbbbba6f08:inspectWebhook" \  -H "Content-Type: application/json" \  -d '{}'
{
  "inspectFailed": false,
  "providerHasUrl": false,
  "providerUrlMatchesExpected": false,
  "providerReportedUrl": "string",
  "lastErrorMessage": "string",
  "lastErrorAt": 0,
  "pendingUpdateCount": 0,
  "errorMessage": "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
}

Generates an inbound webhook URL for this configuration.

For one-webhook-per-credential providers (Telegram, Slack Events API, Twilio, Dialog360) where every chat / channel under the same bot shares one URL. The full URL is shown exactly once in the response — read paths only ever expose the template + key prefix. Re-mint via `/webhook:rotate` if the URL is lost; that revokes the previous key, so the operator must re-register the new URL with the provider before traffic resumes. Returns 400 when the integration declares per-binding webhook ownership (the binding-level mint is the right surface for those — activations flow automatically through participant create / update), or when this config already has a key bound (use `/webhook:rotate` to refresh).

Updates a configuration.

Patches the draft state of the config only; the published revision is untouched until `:publish` is called again. Fields left null on the request body are preserved, so this is safe for partial updates of `DisplayName`, `Parameters`, `Auth`, or `AuthMap`.