Integrations

What it is

The Integrations feature provides a catalog of external service connections. Currently supported: Atlassian (Jira and Confluence). Each integration has a card-based overview, a detail page with configuration, and a visual flow diagram showing data exchange.

Why it matters

Delivery teams do not work in isolation. Integrations pull context from tools teams already use (Jira for issue tracking, Confluence for documentation) and push Foundry outputs back, reducing context-switching and duplicate data entry.

Key concepts

Integration card: IntegrationCard shows the integration name, status, and summary
Integration filters: IntegrationFilters narrow the catalog by type or status
Integration detail page: Full configuration and status view per integration
Flow diagram: IntegrationFlowDiagram visualizes the data exchange between Foundry and the external service
New integration page: NewIntegrationPage guides through connecting a new service
Atlassian connection: OAuth-based connection with AES-256-GCM encrypted credentials
- Jira sync: Sync mode options — auto, auto_status_only, approval_required
- Confluence ingest: Auto-import Confluence pages as discovery documents with optional filter
Webhook processing: Both Jira and Confluence webhooks follow the durable event buffer pattern (HMAC validation, raw event storage, async processing)

How to use it

Navigate to [Program] > Integrations (or configure from Settings).
Browse the integration catalog.
Click New Integration to connect a service.
For Atlassian: complete the OAuth flow, select your Jira project and Confluence space.
Configure sync mode (auto, status-only, or approval-required).
View the flow diagram to understand what data flows between systems.
Monitor sync status from the integration detail page.