← Tools Reference

Convex

Convex integration (Developer Tools). Imported from open-connector.

OAuth19 toolshttps://{trimmed}.convex.cloud
GET
convex_get_token_details
Return the current Convex token details so you can discover the authorized team or project context.

/token_details

GET
convex_list_projects
List all Convex projects for a team.

/list_projects

1 parameter
ParamTypeRequiredDescription
team_idintegerrequiredThe Convex team ID.
POST
convex_create_project
Create a Convex project on a team, optionally provisioning an initial dev or prod deployment.

/create_project

5 parameters
ParamTypeRequiredDescription
team_idintegerrequiredThe Convex team ID.
projectNamestringrequiredThe project name.
deploymentTypestringoptionalThe initial deployment type.
deploymentClassstringoptionalThe deployment class.
deploymentRegionstringoptionalThe deployment region.
GET
convex_get_project_by_id
Get a Convex project by numeric project ID.

/projects/{projectId}

2 parameters
ParamTypeRequiredDescription
project_idintegerrequiredThe Convex project ID.
projectIdstringrequiredPath parameter: projectId
GET
convex_get_project_by_slug
Get a Convex project by team identifier or slug plus project slug.

/teams/{teamIdOrSlug}/projects/{projectSlug}

4 parameters
ParamTypeRequiredDescription
team_id_or_slugstringrequiredThe Convex team ID or slug.
project_slugstringrequiredThe project slug.
teamIdOrSlugstringrequiredPath parameter: teamIdOrSlug
projectSlugstringrequiredPath parameter: projectSlug
GET
convex_list_deployments
List deployments for a Convex project.

/list_deployments

4 parameters
ParamTypeRequiredDescription
project_idintegerrequiredThe Convex project ID.
includeLocalbooleanoptionalWhether to include local deployments.
isDefaultbooleanoptionalWhether to filter to default deployments.
deploymentTypestringoptionalDeployment type filter.
GET
convex_get_deployment
Get a cloud deployment by deployment name.

/deployments/{deploymentName}

2 parameters
ParamTypeRequiredDescription
deployment_namestringrequiredThe deployment name.
deploymentNamestringrequiredPath parameter: deploymentName
POST
convex_delete_deployment
Delete a Convex deployment and all of its data.

/deployments/{deploymentName}/delete

2 parameters
ParamTypeRequiredDescription
deployment_namestringrequiredThe deployment name.
deploymentNamestringrequiredPath parameter: deploymentName
GET
convex_list_deployment_classes
List available deployment classes for a Convex team.

/teams/{teamId}/list_deployment_classes

2 parameters
ParamTypeRequiredDescription
team_idintegerrequiredThe Convex team ID.
teamIdstringrequiredPath parameter: teamId
GET
convex_list_deployment_regions
List available deployment regions for a Convex team.

/teams/{teamId}/list_deployment_regions

2 parameters
ParamTypeRequiredDescription
team_idintegerrequiredThe Convex team ID.
teamIdstringrequiredPath parameter: teamId
POST
convex_create_deploy_key
Create a deploy key for a Convex deployment.

/deployments/{deploymentName}/create_deploy_key

3 parameters
ParamTypeRequiredDescription
deployment_namestringrequiredThe deployment name.
namestringrequiredThe deploy key name.
deploymentNamestringrequiredPath parameter: deploymentName
GET
convex_list_deploy_keys
List deploy keys for a Convex deployment.

/deployments/{deploymentName}/list_deploy_keys

2 parameters
ParamTypeRequiredDescription
deployment_namestringrequiredThe deployment name.
deploymentNamestringrequiredPath parameter: deploymentName
POST
convex_delete_deploy_key
Delete a deploy key for a Convex deployment.

/deployments/{deploymentName}/delete_deploy_key

3 parameters
ParamTypeRequiredDescription
deployment_namestringrequiredThe deployment name.
idstringrequiredThe deploy key ID.
deploymentNamestringrequiredPath parameter: deploymentName
GET
convex_list_custom_domains
List custom domains configured for a Convex deployment.

/deployments/{deploymentName}/custom_domains

2 parameters
ParamTypeRequiredDescription
deployment_namestringrequiredThe deployment name.
deploymentNamestringrequiredPath parameter: deploymentName
POST
convex_delete_custom_domain
Remove a custom domain from a Convex deployment.

/deployments/{deploymentName}/delete_custom_domain

3 parameters
ParamTypeRequiredDescription
deployment_namestringrequiredThe deployment name.
domainstringrequiredThe custom domain.
deploymentNamestringrequiredPath parameter: deploymentName
POST
convex_run_query
Execute a Convex query through the deployment HTTP API.

/api/query

4 parameters
ParamTypeRequiredDescription
pathstringrequiredThe Convex function path.
argsobjectoptionalConvex function arguments.
formatstringoptionalRequest JSON result format.
deployment_urlstringoptionalThe hosted *.convex.cloud deployment URL or deployment name prefix for the quer…
POST
convex_run_mutation
Execute a Convex mutation through the deployment HTTP API.

/api/mutation

4 parameters
ParamTypeRequiredDescription
pathstringrequiredThe Convex function path.
argsobjectoptionalConvex function arguments.
formatstringoptionalRequest JSON result format.
deployment_urlstringoptionalThe hosted *.convex.cloud deployment URL or deployment name prefix for the muta…
POST
convex_run_action
Execute a Convex action through the deployment HTTP API.

/api/action

4 parameters
ParamTypeRequiredDescription
pathstringrequiredThe Convex function path.
argsobjectoptionalConvex function arguments.
formatstringoptionalRequest JSON result format.
deployment_urlstringoptionalThe hosted *.convex.cloud deployment URL or deployment name prefix for the acti…
POST
convex_run_function
Execute an arbitrary Convex function through `/api/run/{functionIdentifier}`.

/api/run/{functionIdentifier}

4 parameters
ParamTypeRequiredDescription
functionIdentifierstringrequiredThe slash or colon separated function identifier.
argsobjectoptionalConvex function arguments.
formatstringoptional
deployment_urlstringoptionalThe hosted *.convex.cloud deployment URL or deployment name prefix.