VZN API

Build with VZN in your product.

Chat, jobs, campaigns and typed decisions over REST. The same routes the desk uses, with a scoped key or a desk token, are documented for your own clients.

What you can call today

  • Start a job and stream its reasoning and result.
  • Run a campaign and read the approved lines back.
  • Send a message to the decision engine and get a typed intent back.

How to connect

  • Use the documented routes with a desk token or a scoped connection key.
  • Connect an AI client over MCP with an allowlist of tools.
  • A typed SDK is specified; the HTTP API it wraps is documented and in use.

Quickstart

These addresses are on https://vznlabs.io. The site Worker forwards them to the Kernel. Replace YOUR-SLUG with a chat channel slug and keep the desk token and the MCP authorization value out of source control.

curl https://vznlabs.io/public/chat/YOUR-SLUG/send \
  -H "content-type: application/json" \
  -d '{"visitor":"k3j9x0w2m4n8q7r1","text":"How much for a full service?"}'

curl https://vznlabs.io/api/inbox/jobs \
  -H "authorization: Bearer $DESK_TOKEN"

curl -s https://vznlabs.io/mcp \
  -H "Authorization: $VZN_MCP_AUTH" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'