Quickstart

Send your first event in five minutes.

1. Get an API key

Open the Obsivara dashboard, go to Settings → API Keys, and create a new key with the ingest:write scope. Your key will start with obs_live_.

See Authentication for detailed steps and scope reference.

2. Send an event

Replace obs_live_YOUR_KEY with your actual key and run:

bash

curl -X POST https://api.obsivara.com/ingest/webhook/generic \
  -H "Authorization: Bearer obs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Obsivara-Asset-Id: my-first-agent" \
  -d '{
    "event": "run_started",
    "run_id": "demo-run-1",
    "asset_id": "my-first-agent",
    "name": "My first run",
    "input": "hello world"
  }'

This sends a run_started event for an asset called my-first-agent. The run_id ties events in a run together — it can be any string.

3. Confirm the 202

A successful ingest returns HTTP 202 with:

json

{ "source": "generic", "accepted": 1, "rejected": 0, "errors": [] }

run_id can be any string — Obsivara maps it to a stable UUID for you. You can use a human-readable identifier like order-123 or my-first-run and it will be consistently tracked.

4. See it in the dashboard

Your event will appear in the dashboard within about one minute. Head to Verify it worked to confirm the run landed and see what to check next.