Product ReleaseApril 22, 2026

convex v1.36.0

convex v1.36.0
Ian Macartney

Ian Macartney

Published on April 22, 2026

Overview

  • npx convex run now supports --inline-query for evaluating readonly queries without creating a named function first, for example: npx convex run --inline-query 'await ctx.db.query("messages").take(5)'.
  • Added ctx.meta to access extra metadata at runtime:
    • ctx.meta.getFunctionMetadata(): the current function's name, component, visibility, and whether it's a query, mutation, or action.
    • ctx.meta.getTransactionMetrics(): how much capacity remains in the current transaction. Only available in queries and mutations.
  • Added a npx convex env default command for getting and setting default environment variables for a project.
  • npx convex deploy now supports a --message option that allows you to write details in the deployment’s audit log. When running npx convex deploy on CI runners on popular platforms (including GitHub Actions, Vercel, and Netlify), a default message will be provided if you don’t provide one (e.g. “Deployed from GitHub Actions • e83c516”).
  • When deploying to a preview deployment, you can now reuse the existing deployment instead of creating a new one by using --preview-name instead of --preview-create. This behavior is also used when deploying to preview deployments from the CI without specifying --preview-create explictly, but you can specify --preview-create explicitly to restore the old behavior. When using the --preview-run flag, the function only runs when a new deployment is created.
  • npx convex codegen can now automatically start a local backend when necessary.
  • You can now increase the timeout used by the CLI when starting a local backend with CONVEX_LOCAL_BACKEND_STARTUP_TIMEOUT_SECS; this can be useful when using large local databases.
  • Fixed a bug where npx convex ai-files remove would also remove skill files that were not installed by npx convex ai-files
  • Fixed a bug where the automatically-generated files would sometimes sort imports in inconsistent order across platforms.
  • Fixed a bug in npx convex dev --start where, in some cases, the --start command would continue to run after closing the Convex dev server with <kbd>Ctrl+C</kbd>.
  • Generating APIs via function-spec now supports validators with int64 literals.

Included Features (6)

#321
Re-use preview deployments

Change the default behavior of preview deployments to re-use rather than creating a new deployment on each build. Allow re-creating by explicitly passing --preview-create

Completed
#320
Annotate a deployment with a custom message

Allow passing a --message to npx convex deploy, and provide defaults from common CI environments

Completed
#319
Default environment variable management from the CLI

Allow setting and getting default environment variables via npx convex env default get/list/set

50(1)
Completed
#318
Access current function's metadata

Surface the currently executing function's name, component, function type (query/mutation/action) and visibility.

50(1)
Completed
#317
Reflect transaction headroom at runtime

Allow queries and mutations to inspect how much bandwidth has been consumed so far, so they can stop early or observe how much bandwidth sub-transactions took

20(1)
Completed
#246
Multiple production/staging deployments

Support multiple long-lived production and staging deployments per project so teams can segment apps, regions, or customer environments more cleanly.

683(20)
Completed