---
title: "Northflank integration for LuumenAI"
url: "https://www.luumen.ai/integrations/northflank/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Northflank integration for LuumenAI

Read Northflank projects and secrets, then change them as approved steps

## What LuumenAI can do with Northflank

LuumenAI connects to Northflank with an API token and exposes 20 tools (13 read-only · 6 write · 1 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 20 tools (13 read-only · 6 write · 1 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About Northflank with LuumenAI

Connect Northflank and Luumen can read your team's projects, pipelines, regions, plans, and secret groups on request. Ask what a project is running or which secrets it holds, and the answer comes back right away. Changes — creating a project, rotating a value in a secret group — are previewed first and, by default, wait for your approval.

## Example tools

Read-only (13 in total):

- `NORTHFLANK_GET_DNS_ID` — Retrieve the DNS identifier for the authenticated account.
- `NORTHFLANK_GET_PROJECT` — Retrieve detailed information about a specific Northflank project.
- `NORTHFLANK_GET_SECRET` — Retrieve a secret from a Northflank project including its contents.
- `NORTHFLANK_GET_SECRET_DETAILS` — View a secret with details about its linked addons from a Northflank project.
- `NORTHFLANK_LIST_ADDON_TYPES` — Retrieve information about available addon types in Northflank.
- `NORTHFLANK_LIST_CLOUD_PROVIDER_NODE_TYPES` — Retrieve supported cloud provider node types available on Northflank.
- `NORTHFLANK_LIST_CLOUD_PROVIDER_REGIONS` — Retrieve supported cloud provider regions available on Northflank.
- `NORTHFLANK_LIST_PIPELINES` — List all pipelines for a Northflank project.

Write and destructive (7 in total, approval required by default):

- `NORTHFLANK_CREATE_OR_UPDATE_PROJECT` — Create a new project or update an existing project in Northflank (upsert operation).
- `NORTHFLANK_CREATE_OR_UPDATE_SECRET` — Create or update a secret group in a Northflank project.
- `NORTHFLANK_CREATE_SECRET` — Create a secret group in a Northflank project.
- `NORTHFLANK_DELETE_PROJECT` — Permanently delete a Northflank project and all associated resources.
- `NORTHFLANK_PATCH_SECRET` — Partially update a secret group in a Northflank project.
- `NORTHFLANK_UPDATE_PROJECT` — Update a project in Northflank.
- `NORTHFLANK_UPDATE_SECRET` — Update a secret in a Northflank project.

## Frequently asked questions

### How does LuumenAI connect to Northflank?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Northflank on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Northflank — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/northflank/