POST /api/v1/events

curl https://flux.brainzlab.ai/api/v1/events \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "user.signup",
    "timestamp": "2024-01-15T10:30:00Z",
    "user_id": "user_123",
    "value": 29.99,
    "properties": {
      "plan": "pro",
      "source": "google_ads",
      "referrer": "blog-post-123"
    },
    "tags": {
      "environment": "production",
      "region": "us-east"
    }
  }'

{
  "data": {
    "id": "evt_abc123",
    "name": "user.signup",
    "timestamp": "2024-01-15T10:30:00Z",
    "user_id": "user_123",
    "value": 29.99
  }
}

POST /api/v1/events/batch

curl https://flux.brainzlab.ai/api/v1/events/batch \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "name": "page.viewed",
        "user_id": "user_123",
        "properties": { "page": "/pricing" }
      },
      {
        "name": "button.clicked",
        "user_id": "user_123",
        "properties": { "button": "signup_cta" }
      }
    ]
  }'

{
  "data": {
    "accepted": 2,
    "rejected": 0
  }
}

GET /api/v1/events

curl "https://flux.brainzlab.ai/api/v1/events?\
name=user.signup&\
from=2024-01-01T00:00:00Z&\
to=2024-01-31T23:59:59Z&\
tags[plan]=pro&\
limit=50" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "data": [
    {
      "id": "evt_abc123",
      "name": "user.signup",
      "timestamp": "2024-01-15T10:30:00Z",
      "user_id": "user_123",
      "value": 29.99,
      "properties": { "plan": "pro" },
      "tags": { "environment": "production" }
    }
  ],
  "meta": {
    "total": 234,
    "limit": 50,
    "offset": 0
  }
}

GET /api/v1/events/count

curl "https://flux.brainzlab.ai/api/v1/events/count?\
name=user.signup&\
from=2024-01-01&\
to=2024-01-31&\
interval=1d" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "data": {
    "total": 1234,
    "series": [
      { "timestamp": "2024-01-01T00:00:00Z", "count": 45 },
      { "timestamp": "2024-01-02T00:00:00Z", "count": 52 },
      { "timestamp": "2024-01-03T00:00:00Z", "count": 38 }
    ]
  }
}

curl "https://flux.brainzlab.ai/api/v1/events/count?\
name=user.signup&\
group_by=tags.plan" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "data": {
    "total": 1234,
    "groups": {
      "pro": 567,
      "starter": 456,
      "enterprise": 211
    }
  }
}

GET /api/v1/events/stats

curl "https://flux.brainzlab.ai/api/v1/events/stats?\
name=order.placed&\
field=value&\
from=2024-01-01&\
to=2024-01-31" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "data": {
    "count": 1234,
    "sum": 98765.43,
    "avg": 80.03,
    "min": 9.99,
    "max": 499.99,
    "p50": 65.00,
    "p95": 199.99,
    "p99": 349.99
  }
}