Account – Settings – Integrations

Route

• Path: /account/settings/integrations (TBD)
• Parent: settings.md

Purpose (business goal)

Manage third-party integrations that extend or support channel/app functionality.

User roles & permissions

• Workspace Admin / Org Admin (TBD)
• Permissions: integrations.manage (TBD)

Reference: Roles & Permissions Model

Layout structure

• Integration catalog
• Installed integrations list
• Configuration panels

Components used

TBD

States

• Empty: no integrations installed
• Loading: fetch integration catalog/config
• Error: configuration invalid / permission denied
• Complete: integration configured

Business logic (high-level)

• Integrations must be workspace-scoped unless explicitly org-scoped.

Domain refs:

• Domain: Workspaces
• Domain: Channels

API dependencies

• GET /integrations
• PUT /integrations/{id}/config

Enterprise constraints

• Integration configuration must be scoped (workspace vs org) and never leak across tenants.
• Secrets must be stored/handled securely; UI must mask sensitive values.

Edge cases

• Integration requires re-auth; configuration appears valid but is degraded (TBD).
• Integration config changes while jobs are running; rollover behavior is TBD.

Security & compliance considerations

• Protect integration secrets; audit changes

Reference: Security & Compliance

Analytics events (if applicable)

TBD

Reference: Analytics Events (MVP)