---
title: "Needle integration for LuumenAI"
url: "https://www.luumen.ai/integrations/needle/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Needle integration for LuumenAI

Semantic search over your runbooks and docs, with indexing changes held for approval

## What LuumenAI can do with Needle

LuumenAI connects to Needle with an API token and exposes 16 tools (10 read-only · 4 write · 2 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 16 tools (10 read-only · 4 write · 2 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: AI & automation

## About Needle with LuumenAI

Needle keeps your runbooks, postmortems, and vendor docs in searchable collections. Luumen queries them during an incident and cites the source files, so an answer comes back with something you can open and check. Adding or removing files from a collection is a previewed step you approve. Luumen connects with an API key.

## Example tools

Read-only (10 in total):

- `NEEDLE_GET_COLLECTION` — Retrieve details for a specific collection by its ID.
- `NEEDLE_GET_COLLECTION_STATS` — Retrieve statistics for a specific collection by its ID.
- `NEEDLE_GET_FILE_DOWNLOAD_URL` — Get a short-lived signed private download URL for a Needle file.
- `NEEDLE_GET_FILE_UPLOAD_URL` — Get signed URLs for uploading local files to Needle.
- `NEEDLE_GET_LOCAL_CONNECTOR` — Retrieve details of a local connector by its ID.
- `NEEDLE_LIST_COLLECTION_FILES` — List all files within a specific collection by its ID.
- `NEEDLE_LIST_COLLECTIONS` — List collections.
- `NEEDLE_LIST_CONNECTORS` — List connectors.

Write and destructive (6 in total, subject to configured approval policy):

- `NEEDLE_ADD_FILES_TO_COLLECTION` — Add files to a collection by providing file URLs.
- `NEEDLE_ADD_FILES_TO_LOCAL_CONNECTOR` — Add files to a local connector by providing file metadata.
- `NEEDLE_CREATE_COLLECTION` — Create a new collection.
- `NEEDLE_CREATE_LOCAL_CONNECTOR` — Create a local connector that monitors specified folders on a device.
- `NEEDLE_DELETE_FILES_FROM_COLLECTION` — Delete files from a specific collection by providing file IDs.
- `NEEDLE_DELETE_FILES_FROM_LOCAL_CONNECTOR` — Delete files from a local connector by filename or file IDs.

## Frequently asked questions

### How does LuumenAI connect to Needle?

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 Needle on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

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

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