Skip to main content

Your First Snippet

This guide walks you from creating a snippet to invoking it.

Create a snippet in the admin portal​

  1. Open http://localhost:8092
  2. Sign in
  3. Go to Snippets
  4. Create a new snippet
  5. Choose language: Bun or Python
  6. Add your handler code
  7. Publish to dev

Invoke from the UI​

Use the built-in test panel in the snippet editor to run your snippet immediately.

Invoke from the API​

Use an API key and tenant slug.

KEY=vl_xxxx
TENANT=myorg
SNIPPET=<snippet-id-or-slug>

curl -s -X POST "http://localhost:8080/v1/invoke/$TENANT/$SNIPPET" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"world"}'

Environments and versions​

  • dev: fast iteration
  • staging: pre-production checks
  • prod: stable traffic

Each publish creates an immutable version, so rollback is straightforward.

What to do next​

  • Read ../invoke/invocation-modes.md for sync/async/stream behavior
  • Read ../integrations/overview.md to call third-party APIs from snippets