deploy_function
Deploy a Node 22 serverless function to a project with optional npm dependencies, cron schedule, and memory/timeout config. Returns bundled runtime version and dependency resolution details.
Instructions
Deploy a serverless function (Node 22) to a project. Handler signature: export default async (req: Request) => Response. The function can import { db, adminDb, auth, email, ai } from '@run402/functions' — auto-bundled by the platform. Additional npm packages are bundled at deploy time when listed in deps (bare names resolve to latest; pinned/range specs are honored verbatim; @run402/functions and run402-functions rejected; max 30 entries; native binaries rejected). For schedule/email background triggers, prefer a unified deploy manifest with functions.replace.<name>.triggers[] so every trigger creates a durable function run. The response includes runtime_version (the bundled @run402/functions version — surface as 'Functions runtime version', never bare 'runtime'), deps_resolved (map of dep name → installed concrete version), and an optional top-level warnings array (sibling to the function record).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | TypeScript or JavaScript source code. Must export a default async function: export default async (req: Request) => Response | |
| deps | No | Optional npm package specs to install and bundle. Bare names (e.g. 'lodash') resolve to latest at deploy time; pinned (e.g. 'lodash@4.17.21') or range specs ('date-fns@^3.0.0') are honored verbatim. '@run402/functions' (auto-bundled) and 'run402-functions' (legacy name) are rejected. Max 30 entries, max 200 chars per spec. Native binary modules (sharp, canvas, native bcrypt, etc.) are rejected. | |
| name | Yes | Function name (URL-safe slug: lowercase, hyphens, alphanumeric, e.g. 'stripe-webhook') | |
| config | No | Optional function configuration | |
| schedule | No | Cron expression (5-field, e.g. '*/15 * * * *') to run the function on a schedule. Pass null to remove an existing schedule. | |
| project_id | Yes | The project ID to deploy the function to |