Quickstart

From zero to a scored event in about a minute. You will create a workspace, generate an API key, and send one POST.

1. Create a workspace

2. Generate an API key

Open Dashboard → API keys, give the key a name (e.g. Production), click Generate, and copy the vl_live_… string immediately. We never show it again — only its prefix.

Treat the key like a password. Put it in a server-side secret store, not in the browser bundle of a client app.

3. Health check

Confirm the gateway is reachable from your environment:

bash

curl https://YOUR-APP.lovable.app/api/public/v1/health

You should get back a JSON body with "status": "ok".

4. Send your first event

Replace the URL host and key, then run:

bash

curl -X POST https://YOUR-APP.lovable.app/api/public/v1/evaluate \
  -H "Authorization: Bearer vl_live_REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "u_42",
    "ip": "203.0.113.7",
    "deviceId": "d_xyz",
    "action": "login"
  }'

Example response

json

{
  "eventId": "f3a1…",
  "riskScore": 41,
  "decision": "REVIEW",
  "confidence": 62,
  "reasonSignals": ["new_device", "new_ip"],
  "signalContributions": { "new_device": 1, "new_ip": 0.7 },
  "modelVersion": "workspace-v1"
}

5. Teach it

From the dashboard, open the event you just sent and label it. Or do it via API with the eventId you got back:

bash

curl -X POST https://YOUR-APP.lovable.app/api/public/v1/feedback \
  -H "Authorization: Bearer vl_live_REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{ "eventId": "f3a1…", "label": "SAFE" }'

6. Wire it into your app

Head to Integration recipes for drop-in Express, Next.js, API gateway, and browser HTML examples.