name: convex-http-actions description: Adds HTTP endpoints in convex/http.ts: webhook receivers with signature checks, REST style routes, CORS, auth headers, streaming responses, and file uploads over HTTP. Use when integrating Stripe, Clerk, Resend, or any service that calls back into the app, or when a client needs a plain HTTP API.

Convex HTTP actions

Defines public HTTP endpoints served from the deployment's .convex.site domain. The one rule: an httpAction handler treats every byte of the request as untrusted, verifies it, then calls internal.* functions with ctx.runQuery or ctx.runMutation. It never reads or writes ctx.db directly.

When to reach for this

• A third party (Stripe, Clerk, Resend, GitHub) needs a URL to POST events to
• A client without the Convex SDK (mobile app, CLI, another backend) needs a plain HTTP API
• A browser needs to download or stream bytes without going through useQuery
• A script or form needs to upload bytes over HTTP instead of an upload URL

httpAction or mutation