Writing Custom Functions

Documentation Index

Fetch the complete documentation index at: https://archie.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Where you write

• In-project IDE — open Backend → Custom functions and use the built-in editor
• Local development — pull the project via GitHub integration, edit in your local IDE, push back

​

Function signature

export async function handler(req: Request, ctx: Context): Promise<Response> {
  const body = await req.json()
  // ... your logic
  return Response.json({ ok: true })
}

​

Patterns

• Validate input — never trust caller-provided data; use a schema validator
• Use the integration clients — ctx.integrations.stripe, ctx.integrations.sendgrid, and so on, are pre-configured with credentials
• Return early on errors — surface clear status codes and JSON error bodies
• Keep functions focused — one function per logical task; compose for workflows
• Log structurally — ctx.logger.info({ event: "checkout-started", userId })

​

Triggers

• HTTP — exposed at /api/functions/<name>
• Scheduled — cron expression, runs at the configured interval
• Webhook — exposed under /api/webhooks/<name>, with signature verification
• Queue — invoked when a message lands in the configured queue

​

Testing

​

FAQ