# Convex AI integration on Definable

> Backend-as-a-Service platform with real-time database, serverless functions, and built-in authentication

## What this connects

Backend-as-a-Service platform with real-time database, serverless functions, and built-in authentication

Vendor: https://convex.dev

## Tools available

**19** tools available. First 12:

- `CONVEX_CREATE_DEPLOY_KEY` — Create deploy key — Tool to create a deploy key for use with the Convex CLI. Use when you need to generate credentials for CLI-based development or deployment workflows. The generated key provides administrative access to the specified deployment.
- `CONVEX_CREATE_DEPLOYMENT` — Create Deployment — Tool to create a new deployment for a Convex project. Use when you need to create a development, production, or custom deployment. Specify the deployment type and optional configuration like class, reference, and region.
- `CONVEX_CREATE_PROJECT` — Create Project — Tool to create a new project on a Convex team, optionally provisioning a dev or prod deployment. Use when you need to initialize a new Convex project in a team.
- `CONVEX_DELETE_CUSTOM_DOMAIN` — Delete Custom Domain — Tool to remove a custom domain from a Convex deployment. Use when you need to delete a previously configured custom domain.
- `CONVEX_DELETE_DEPLOYMENT` — Delete Deployment — Tool to delete a Convex deployment. Use when you need to permanently remove a deployment and all its data. WARNING: This action will delete all data and files in the deployment and cannot be undone.
- `CONVEX_DELETE_PROJECT` — Delete project — Deletes a Convex project and all its deployments permanently. Use when you need to permanently remove a project and all associated data. This operation cannot be undone.
- `CONVEX_EXECUTE_QUERY_BATCH` — Execute Query Batch — Tool to execute multiple Convex query functions in a single batch request. Use when you need to fetch data from multiple queries efficiently in one API call.
- `CONVEX_GET_DEPLOYMENT` — Get Deployment Details — Tool to retrieve details about a Convex cloud deployment. Use when you need to get information about a specific deployment including its configuration, region, creation time, and status.
- `CONVEX_GET_PROJECT_BY_ID` — Get Project by ID — Tool to retrieve detailed information about a specific Convex project by its ID. Use when you need to fetch project metadata including name, slug, team association, and creation time.
- `CONVEX_GET_PROJECT_BY_SLUG` — Get Project by Slug — Tool to retrieve a Convex project by its slug within a team. Use when you need to fetch project details using human-readable identifiers instead of numeric IDs.
- `CONVEX_GET_QUERY_TIMESTAMP` — Get Query Timestamp — Tool to get the latest timestamp for queries from Convex deployment. Use when you need to retrieve the current query timestamp from the Convex API.
- `CONVEX_GET_TOKEN_DETAILS` — Get token details — Tool to retrieve token details for the authenticated token. Returns the team ID for team tokens or project ID for project tokens. Especially useful after receiving a token from an OAuth flow to identify which team or project it belongs to.

## Auth

Auth schemes: `API_KEY`, `API_KEY`, `OAUTH2`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Convex

Inside a Definable workflow, Convex is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Convex** — the Researcher (GPT-5.5) pulls context from Convex (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Convex** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Convex (create record, post message, draft email).
- **Designer / Engineer → Distributor → Convex** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Convex (attach file, open PR comment, post status).

The Verifier checks every Convex call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/convex/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt