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

# DeployHQ integration for LuumenAI

Read your DeployHQ projects and deployments, change build config with approval

## What LuumenAI can do with DeployHQ

LuumenAI connects to DeployHQ with Basic auth and exposes 60 tools (22 read-only · 31 write · 7 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: Basic auth
- Tools available: 60 tools (22 read-only · 31 write · 7 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About DeployHQ with LuumenAI

Connect DeployHQ and your agent can answer questions about projects, repositories, branches, and past deployments without you opening the dashboard. When something needs to change — a config file, an SSH command, an excluded path, repository settings — the agent shows the edit first and waits for your approval before it writes. Luumen authenticates with basic auth.

## Example tools

Read-only (22 in total):

- `DEPLOYHQ_GET_PROJECTS` — Retrieve all projects from DeployHQ account.
- `DEPLOYHQ_GET_PROJECTS_PROJECT` — View an existing project in DeployHQ.
- `DEPLOYHQ_GET_PROJECTS_PROJECT_BUILD_KNOWN_HOSTS` — List all known hosts within a project using DeployHQ API.
- `DEPLOYHQ_GET_PROJECTS_PROJECT_COMMANDS` — Retrieve all SSH commands configured for a project.
- `DEPLOYHQ_GET_PROJECTS_PROJECT_CONFIG_FILES` — Retrieve a list of all config files in a DeployHQ project.
- `DEPLOYHQ_GET_PROJECTS_PROJECT_DEPLOYMENTS` — Retrieve a paginated list of all deployments in a project.
- `DEPLOYHQ_GET_PROJECTS_PROJECT_EXCLUDED_FILES` — List all excluded files within a project template.
- `DEPLOYHQ_GET_PROJECTS_PROJECT_ID_CONFIG_FILES_ID` — View a specific config file in a DeployHQ project.

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

- `DEPLOYHQ_DELETE_COMMAND` — Delete a command from a specified project.
- `DEPLOYHQ_DELETE_PROJECTS_PROJECT` — Delete a project from DeployHQ.
- `DEPLOYHQ_DELETE_PROJECTS_PROJECT_BUILD_CACHE_FILES` — Delete an existing build cache file from a project.
- `DEPLOYHQ_DELETE_PROJECTS_PROJECT_EXCLUDED_FILES_IDENTIFIER` — Delete an existing excluded file rule from a project.
- `DEPLOYHQ_DELETE_PROJECTS_PROJECT_SERVER_GROUPS_IDENTIFIER` — Delete a server group from a project using the DeployHQ API.
- `DEPLOYHQ_DELETE_TEMPLATES_PERMALINK` — Delete a template by its unique permalink.
- `DEPLOYHQ_PATCH_PROJECTS_ID` — Update project settings in DeployHQ.
- `DEPLOYHQ_PATCH_PROJECTS_PROJECT_ID_BUILD_CACHE_FILES_ID` — Update an existing build cache file in a project.

## Frequently asked questions

### How does LuumenAI connect to DeployHQ?

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

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

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

### Is there an audit trail?

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

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