Configuring a Plugin
After installing a plugin, you manage it from Dashboard → Settings → Plugins. This page lists every install in your subaccount with its health, configuration, and audit log.
The installed plugins page
Each row shows:
| Column | What it means |
|---|---|
| Plugin | Logo + name + version |
| Status | Active, Disabled, Failing, or Uninstalling |
| Last event | Timestamp of the most recent webhook delivery |
| 24h success rate | Percentage of webhook attempts that succeeded |
| Actions | Gear icon → full management panel |
Status pills
- Active (green) — install is healthy, webhooks delivering, token valid.
- Disabled (gray) — operator paused webhook delivery; config retained, token still valid.
- Failing (amber) — recent webhook deliveries are erroring; the vendor's endpoint is probably down.
- Uninstalling (gray) — 30-day soft-delete window in progress; the row is removed once it ends.
A plugin that stays in Failing state for 7 continuous days is auto-disabled by Levy. You can re-enable it once the vendor's endpoint is back up.
Edit configuration
Click the gear icon → Configure. The same form you saw at install reopens with your current values prefilled. Save your changes and the plugin starts using the new config on the next event delivery.
You don't need to uninstall and reinstall to change a setting. Common reasons to edit config:
- Move Slack alerts to a different channel
- Tighten or loosen Captur.ai's parking-score threshold
- Change which BigQuery dataset receives the daily export
- Update an API key after a vendor rotates theirs
Disable temporarily
Click Disable to pause webhook delivery without uninstalling. The plugin stays in your list, the config and token are preserved, but Levy stops sending events. Use this for:
- Maintenance windows on the vendor's side
- Investigating a runaway alert volume
- Pausing billing-by-event plugins while you debug
Click Enable to resume.
Rotate the plugin's API token
Plugins authenticate back to /api/plugin/v1/* with a token in the format lvy_plg_<install-id-prefix>_<random>. If you suspect the token leaked:
Open the install
Settings → Plugins → gear icon next to the install.
Click Rotate Token
A new token is issued immediately. The old token enters a 24-hour grace period during which both work — long enough for the vendor to swap.
Notify the vendor
Send the new token to the vendor through their support channel. After 24 hours the old token stops working.
The rotation is logged in the plugin audit log.
View the audit log
Click the gear icon → Audit log. Every action taken against this install is recorded:
| Action | Logged |
|---|---|
install | Initial install with permissions + config |
configure | Each config save |
disable / enable | Pause / resume |
token_rotated | Token rotation |
webhook_sent | Each outbound webhook (sampled at scale) |
webhook_failed | Failed delivery with response body excerpt |
uninstall | Final uninstall with reason |
Logs are retained for 18 months and exportable to CSV.
Replay a failed webhook
If a webhook delivery failed but the vendor's endpoint is now back up, you can replay it manually:
Open the audit log
Settings → Plugins → gear → Audit log.
Find the failed event
Filter by action = webhook_failed. Each row has a Replay button.
Click Replay
The event is re-sent to the vendor immediately. Outcome is recorded as a new audit row.
You have a 7-day replay window from the original event time.
Uninstall
Click Uninstall in the gear menu. You'll be asked to confirm. On confirm:
- Plugin's API token is revoked immediately.
- Webhook subscriptions are paused.
- Configuration enters a 30-day soft-delete window — if you reinstall within that window, your config returns.
- Vendor receives a deletion webhook so they can purge their copy of your data (important for GDPR compliance).
- An
uninstallaudit row is written.
Paid subscriptions are canceled in Stripe; you're billed only for usage through the uninstall timestamp.
What's next
- Plugin billing — how charges work
- Troubleshooting — diagnosing failures