Functions

Create function

Create a new Zavu Function. The function starts in draft status. A dedicated API key is auto-provisioned and injected as the ZAVU_API_KEY secret so the function can call back into the Zavu API without manual setup.

Provide sourceCode to seed the draft. Call POST /v1/functions/{functionId}/deploy afterwards to publish.

post/v1/functions

Request body

slugstring required

URL-safe identifier (lowercase, digits, hyphens). Must be unique per project.

namestring required

descriptionstring

runtime'nodejs24'

Runtime the function is deployed on.

timeoutSecinteger

Per-invocation timeout in seconds. Event and cron invocations are asynchronous, so a long timeout only bounds cost; a tool called during a live conversation holds up the reply, and a function exposed over HTTP is additionally bounded by the platform's HTTP response limit.

memoryMb128 | 256 | 512 | 1024

httpEnabledboolean

Whether to expose a public HTTPS URL for this function.

filesobject

The project's source files, keyed by path relative to the project root (e.g. index.ts, lib/orders.ts). Imports between them are resolved when the function is built, so a function can be split across as many files as it needs.

Paths must be relative and use forward slashes; .., node_modules/ and package.json are rejected. npm packages are not uploaded here — declare them under dependencies and Zavu installs them. Limits: 200 files and 900,000 bytes for the whole tree.

entrypointstring

Which file in files is the entry point. Defaults to index.ts.

sourceCodestring

Shortcut for a single-file function: exactly equivalent to sending files with one entry named after entrypoint (index.ts by default). Fully supported — use whichever fits. If both are sent, files wins.

dependenciesobject

npm dependencies. Keys are package names, values are semver ranges.

Example request

{
  "slug": "order-bot",
  "name": "Order Bot",
  "files": {
    "index.ts": "import { formatOrder } from './lib/orders';\n\nexport default async function handler(event) {\n  return { statusCode: 200, body: formatOrder(event) };\n}\n",
    "lib/orders.ts": "export function formatOrder(event) {\n  return JSON.stringify(event);\n}\n"
  },
  "entrypoint": "index.ts",
  "dependencies": {
    "openai": "^4.20.0"
  }
}

Response

Function created.

Example response

{
  "function": {
    "id": "fn_abc123",
    "slug": "order-bot",
    "name": "Order Bot",
    "timeoutSec": 10,
    "memoryMb": 256,
    "dependencies": {
      "openai": "^4.20.0"
    }
  }
}

Changes

Changed in 4 of the 66 revisions of this API.117

Aug 11, 202655b381c67f262See the full diff
- ○
  added the new optional request property entrypoint
  new-optional-request-property
- ○
  added the new optional request property files
  new-optional-request-property
Aug 5, 2026a08a6318c9862See the full diff
- ○
  the timeoutSec request property default value changed from 10 to 30
  request-property-default-value-changed
- ○
  the timeoutSec request property's max was increased from 30.00 to 180.00
  request-property-max-increased
May 16, 20264e6f9c905c12112See the full diff
- ▲
  removed the enum value nodejs20 of the request property runtime
  request-property-enum-value-removed
- ●
  added the new nodejs24 enum value to the function/runtime response property for the response status 201
  response-property-enum-value-added
- ○
  added the new nodejs24 enum value to the request property runtime
  request-property-enum-value-added
- ○
  removed the nodejs20 enum value from the function/runtime response property for the response status 201
  response-property-enum-value-removed
May 15, 20263e45958691da1See the full diff
- ○
  endpoint added
  endpoint-added

Full history