---
title: "Ingest a public experiment analytics event"
method: POST
path: "/v1/analytics/events"
---

# Ingest a public experiment analytics event

`POST /v1/analytics/events`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/analytics/events`
- Auth: none required

Public sink for proof-led A/B exposure and conversion events. Events are
idempotent on visitor_id, experiment, event, and occurred_at.

## Request body

- AnalyticsEventRequest
  - `experiment` string, required
  - `variant` 'A' | 'B', required
  - `event` string, required
  - `segment` 'compliance' | 'risk' | 'finance' | 'technical' | 'null', nullable
  - `visitor_id` string, required
  - `page_path` string, required
  - `occurred_at` string, date-time, required
  - `metadata` object

## Response `202`

Analytics event accepted

- object
  - `accepted` boolean, required
  - `event_id` string, uuid, required
  - `idempotent_replay` boolean, required
  - `experiment` string, required
  - `variant` 'A' | 'B', required
  - `report` AnalyticsExperimentReport, required
    - `generated_at` string, date-time, required
    - `experiment` string, required
    - `window_days` integer, required
    - `conversion_event` string, nullable, required
    - `variants` AnalyticsConversionRate[], required
      - `variant` 'A' | 'B', required
      - `segment` 'compliance' | 'risk' | 'finance' | 'technical' | 'null', nullable, required
      - `exposed_visitors` integer, required
      - `converted_visitors` integer, required
      - `conversion_rate` number, required
    - `segments` AnalyticsConversionRate[], required
      - `variant` 'A' | 'B', required
      - `segment` 'compliance' | 'risk' | 'finance' | 'technical' | 'null', nullable, required
      - `exposed_visitors` integer, required
      - `converted_visitors` integer, required
      - `conversion_rate` number, required

## Other responses

- `400`: Structured API error
- `503`: Structured API error

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)