Backend-as-a-Service platform with real-time database, serverless functions, and built-in authentication
Backend-as-a-Service platform with real-time database, serverless functions, and built-in authentication On Nagent, Convex is exposed as a fully-configurable developer tools integration that any agent can call — 19 actions, and API_KEY, API_KEY, OAUTH2 authentication. No code is required to wire Convex into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Convex to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Convex into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Convex, with input parameters and output schema. Drop these into any step of an agent built in Helix.
CONVEX_CREATE_DEPLOY_KEYTool 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.
Input parameters
Name for the deploy key. This is a human-readable identifier that helps you remember what this key is used for.
The name of the deployment for which to create the deploy key. This identifies the specific Convex deployment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_CREATE_DEPLOYMENTTool 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.
Input parameters
The type of deployment to create: 'dev' for development, 'prod' for production, or 'custom' for custom deployment
The class to use for this deployment. If not provided, the default deployment class for your team will be used
The region where the deployment should be created
An identifier that uniquely identifies this deployment within the project. By providing a reference, you can create multiple dev and prod deployments in the project. If not provided, a reference will be automatically generated
The ID of the project to create the deployment in
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_CREATE_PROJECTTool 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.
Input parameters
Team ID where the project will be created
Name of the project to create
Type of deployment to create (e.g., 'dev' or 'prod'). If not provided, no deployment will be created initially.
Class to use for the deployment. If not provided, the default deployment class for your team will be used.
Region where the deployment should be hosted. If not provided, uses the default region for your team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_DELETE_CUSTOM_DOMAINTool to remove a custom domain from a Convex deployment. Use when you need to delete a previously configured custom domain.
Input parameters
The custom domain name to delete (e.g., 'test-domain.example.com')
The name of the deployment to delete the custom domain from (e.g., 'quiet-llama-744')
The destination type for this custom domain: 'convexCloud' for Convex Cloud deployments or 'convexSite' for Convex Site deployments
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_DELETE_DEPLOYMENTTool 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.
Input parameters
The name of the deployment to delete. This will permanently delete all data and files in the deployment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_DELETE_PROJECTDeletes 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.
Input parameters
The unique identifier of the project to delete. This will delete the project and all its deployments permanently.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_EXECUTE_QUERY_BATCHTool 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.
Input parameters
Array of query items to execute in the batch. Each item specifies a query function path and its arguments.
Full deployment URL (e.g., 'https://quiet-llama-744.convex.cloud'). If not provided, uses the base_url from auth metadata.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_GET_DEPLOYMENTTool 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.
Input parameters
The name of the deployment to retrieve (e.g., 'quiet-llama-744')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_GET_PROJECT_BY_IDTool 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.
Input parameters
The unique identifier of the project to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_GET_PROJECT_BY_SLUGTool 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.
Input parameters
Project slug (unique identifier within the team) to retrieve
Team ID (numeric) or team slug (string identifier) to scope the project lookup
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_GET_QUERY_TIMESTAMPTool to get the latest timestamp for queries from Convex deployment. Use when you need to retrieve the current query timestamp from the Convex API.
Input parameters
The name of the deployment to get the query timestamp for (e.g., 'quiet-llama-744')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_GET_TOKEN_DETAILSTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_LIST_DEPLOY_KEYSTool to list all deploy keys for a specified Convex deployment. Use when you need to view all authentication tokens that can be used to deploy to this deployment.
Input parameters
The name of the deployment to list deploy keys for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_LIST_DEPLOYMENT_CLASSESTool to list available deployment classes for a Convex team. Use when you need to check which deployment classes are available for a specific team.
Input parameters
The unique identifier of the team to list deployment classes for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_LIST_DEPLOYMENT_REGIONSTool to list available deployment regions for a Convex team. Use when you need to check which regions are available for deploying a team's backend.
Input parameters
The unique identifier for the team whose available deployment regions you want to list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_LIST_DEPLOYMENTSTool to list all deployments for a Convex project. Use when you need to see all deployments (production, preview, or local) for a specific project.
Input parameters
If true, only include default deployments. If false, only include non-default deployments.
Project ID to list deployments for.
If true, include local deployments in the response (filtered to only show local deployments created by the requesting team member).
Only include deployments of the given deployment type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_LIST_LOG_STREAMSTool to list all existing log stream configurations in a deployment. Use when you need to view configured log streaming destinations like Datadog, Webhook, Axiom, or Sentry.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_LIST_PROJECTSTool to list all projects for a specific Convex team. Use when you need to retrieve all projects associated with a team by team ID.
Input parameters
The unique identifier of the team to list projects for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CONVEX_UPDATE_DEPLOYMENTTool to update properties of an existing Convex deployment. Use when you need to modify deployment settings such as dashboard edit confirmation or deployment reference. Only the fields provided in the request are modified.
Input parameters
The reference of the deployment. Must be unique across deployment references in the project. Requirements: 3-100 characters, only lowercase letters, numbers, '-' and '/', cannot follow deployment name format \[a-z\]+-\[a-z\]+-\[0-9\]+, cannot start with 'local-', cannot be reserved keywords: 'prod', 'dev', 'cloud', 'local', 'default', 'name', 'new', 'existing', 'deployment', 'preview'. Set to null to clear the reference.
The name of the deployment to update (e.g., 'quiet-llama-744'). This is the unique identifier for the deployment.
Controls whether the dashboard requires confirmation before allowing edits during a browser session. Set to null to reset to default behavior (true for prod deployments, false for dev and preview). Set to true or false to explicitly override the setting.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 37 agents privately built on Nagent that already use Convex.
Build on Nagent
Connect Convex to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Convex, and click "Connect Now." You'll authenticate with API_KEY, API_KEY, OAUTH2 — Nagent handles credential storage and refresh automatically. Once connected, Convex is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Convex is connected, you configure its 19 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Convex steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Convex event fires, the agent kicks off automatically.
Every Convex action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Convex ships with 19 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Convex together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Convex-based workflows tailored to your business.