## 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:

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

### Example request

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