---
title: "Dovetail integration for LuumenAI"
url: "https://www.luumen.ai/integrations/dovetail/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Dovetail integration for LuumenAI

Read research projects, notes, and insights, then write findings back with approval

## What LuumenAI can do with Dovetail

LuumenAI connects to Dovetail with an API token and exposes 51 tools (25 read-only · 20 write · 6 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: 51 tools (25 read-only · 20 write · 6 destructive)
- Plan: available on all plans
- Category: Databases & data platforms

## About Dovetail with LuumenAI

Connect Dovetail and Luumen can read your research workspace directly in the terminal — projects, notes, docs, data items, and published insights. Ask what a round of interviews said about onboarding, or pull a doc as Markdown for a postmortem. When something needs writing back, like a new insight or a project for the next study, Luumen shows the change first and asks before it runs. Authentication is by API key.

## Example tools

Read-only (25 in total):

- `DOVETAIL_EXPORT_DATA` — Export data in HTML or Markdown format.
- `DOVETAIL_EXPORT_DOC` — Export a doc in HTML or Markdown format.
- `DOVETAIL_EXPORT_INSIGHT` — Export an insight in HTML or Markdown format.
- `DOVETAIL_EXPORT_NOTE` — Export a note from Dovetail in HTML or Markdown format.
- `DOVETAIL_GET_CONTACT` — Retrieve details of a specific contact.
- `DOVETAIL_GET_DATA` — Retrieve details of a specific data item by ID.
- `DOVETAIL_GET_DOC` — Retrieve details of a specific doc by ID.
- `DOVETAIL_GET_FILE` — Retrieve details of a specific file by its ID.

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

- `DOVETAIL_CREATE_CHANNEL` — Creates a new channel in Dovetail to organize and collect feedback data.
- `DOVETAIL_CREATE_CONTACT` — Create a new contact in Dovetail.
- `DOVETAIL_CREATE_DATA` — Create a data item in a Dovetail project with text content, title, and/or structured fields.
- `DOVETAIL_CREATE_DATA_POINT` — Create a data point within a channel.
- `DOVETAIL_CREATE_DOC` — Create a doc in a Dovetail project with text content, title and/or custom fields.
- `DOVETAIL_CREATE_INSIGHT` — Creates a new insight in Dovetail to store synthesized research findings, observations, or conclusions.
- `DOVETAIL_CREATE_NOTE` — Create a note in a Dovetail project with text content, title and/or custom fields.
- `DOVETAIL_CREATE_PROJECT` — Create a new project in your Dovetail workspace.

## Frequently asked questions

### How does LuumenAI connect to Dovetail?

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

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

### Is there an audit trail?

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

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