ConnectCloud Developers

Give a webhook trigger a new token and signing secret (tenant:flows:write|admin; scoped flows the owning module's manage)

POST /api/flows/v1/flows/{id}/triggers/{trigger}/rotate

Module: Flows · operationId: rotateFlowWebhook · Tag: Flows · Auth: access token (Authorization: Bearer <accessToken>)

The old token and secret stop at once. The answer is the only place the new ones are shown.

Parameters

Name In Type Required Description
id path string (uuid) yes
trigger path string yes

Responses

  • 200 The new credentials (application/json)
  • 401 Missing, invalid or expired token (no body).
  • 403 The token lacks the permission or has no active tenant (forbidden). Also: person_required (a service-account key on personal flows or the task inbox), live_test_forbidden, forbidden_grant, starter_excluded. (application/json)
  • 404 The record does not exist in the token's tenant – or it belongs to a scope the caller may not view (a scoped flow stays hidden). (application/json)
  • 409 The state does not allow it: version_conflict (reload), no_changes, archived, key_taken, flow_disabled, flow_tripped, task_closed, run_finished. (application/json)
  • 422 invalid_definition (details.diagnostics), permission_missing (details.groups), owner_inactive, owner_not_found, not_published, key_changed, not_webhook, filter_failed, unknown_trigger, no_manual_trigger. (application/json)
  • 503 A dependency is not available: scope_unavailable (the module that owns a flow's scope did not answer who may see and manage it – nothing of a scoped flow is shown or changed), identity_unavailable (HR), ai_unavailable, ai_failed. (application/json)

Fields of the 200 answer:

  • path (string, required): The address on the portal origin: /api/flows/v1/hooks/{token}
  • token (string, required): The webhook token (the credential in the path)
  • trigger (string, required): The trigger's id
  • secret (string): auth hmac: signs the body, header X-Flows-Signature: sha256=<hex of HMAC-SHA256(secret, body)>

Example 200 answer:

{
  "path": "/api/flows/v1/hooks/fw_EXAMPLE7Vb2mX9kT4rL8nW3pZ6cY1f",
  "secret": "whsec_EXAMPLEq4Lm8Rt2Vx6Zb0Nc3Fh7Jk1",
  "token": "fw_EXAMPLE7Vb2mX9kT4rL8nW3pZ6cY1f",
  "trigger": "shop_bestellung"
}

Example request

curl -X POST 'https://api.mbcom.cloud/api/flows/v1/flows/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/triggers/string/rotate' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI