Managing Integrations

An integration connects Lumos to one of your apps — like Okta or Datadog — so Lumos can sync that app's accounts and entitlements for you to review and manage. You can set up and maintain these connections by hand in the Lumos UI, or manage them programmatically so they're repeatable, reviewable, and version controlled.

These guides cover the programmatic paths:

• Managing Integrations via API — Connect, reconnect, sync, and disconnect integrations by calling the REST endpoints directly. Best when you're wiring things up from a script, a CI pipeline, or any tool that speaks HTTP.
• Managing Integrations via Terraform — Declare each integration as a lumos_app resource and manage it as code with terraform apply. Best when you want infrastructure-as-code change control: plan, review, and audit every change alongside the rest of your infrastructure.
• Syncing Integrations via API — Trigger a sync on demand for an integration that's already connected, no matter how it was connected (in the Lumos UI, via the API, or via Terraform). Best when you just want fresh data in Lumos at a moment you choose — after automation changes an app, from CI, or before an access review — without managing the connection programmatically.

All three paths use the same underlying /v1/apps endpoints and require a Lumos API token from an admin who can manage integrations. Pick the API guide if you want direct control over each call, the Terraform guide if you'd rather describe the end state and let Terraform reconcile it, or the sync guide if the connections are already in place and you only need to refresh their data.