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

# Convex integration for LuumenAI

Read Convex projects and deployments, then make changes as approved steps

## What LuumenAI can do with Convex

LuumenAI connects to Convex with an API token and exposes 19 tools (12 read-only · 4 write · 3 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: 19 tools (12 read-only · 4 write · 3 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About Convex with LuumenAI

Connect Convex and your agent can see the shape of your backend: which projects a team owns, what deployments sit under each one, which deploy keys exist, and how log streams are configured. It reads that on request and answers right away. Changes like creating a deployment or issuing a deploy key are previewed first and go out as approved, audited steps.

## Example tools

Read-only (12 in total):

- `CONVEX_EXECUTE_QUERY_BATCH` — Execute multiple Convex query functions in a single batch request.
- `CONVEX_GET_DEPLOYMENT` — Retrieve details about a Convex cloud deployment.
- `CONVEX_GET_PROJECT_BY_ID` — Retrieve detailed information about a specific Convex project by its ID.
- `CONVEX_GET_PROJECT_BY_SLUG` — Retrieve a Convex project by its slug within a team.
- `CONVEX_GET_QUERY_TIMESTAMP` — Get the latest timestamp for queries from Convex deployment.
- `CONVEX_GET_TOKEN_DETAILS` — Retrieve token details for the authenticated token.
- `CONVEX_LIST_DEPLOY_KEYS` — List all deploy keys for a specified Convex deployment.
- `CONVEX_LIST_DEPLOYMENT_CLASSES` — List available deployment classes for a Convex team.

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

- `CONVEX_CREATE_DEPLOY_KEY` — Create a deploy key for use with the Convex CLI.
- `CONVEX_CREATE_DEPLOYMENT` — Create a new deployment for a Convex project.
- `CONVEX_CREATE_PROJECT` — Create a new project on a Convex team, optionally provisioning a dev or prod deployment.
- `CONVEX_DELETE_CUSTOM_DOMAIN` — Remove a custom domain from a Convex deployment.
- `CONVEX_DELETE_DEPLOYMENT` — Delete a Convex deployment.
- `CONVEX_DELETE_PROJECT` — Deletes a Convex project and all its deployments permanently.
- `CONVEX_UPDATE_DEPLOYMENT` — Update properties of an existing Convex deployment.

## Frequently asked questions

### How does LuumenAI connect to Convex?

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

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

### Is there an audit trail?

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

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