Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

If using Bearer auth, pass the Secret Key as the token:

Body

application/json
experimentId
string
required

The experiment to create a report for

title
string

Report title (defaults to experiment name)

description
string

Report description

statsEngine
enum<string>

Stats engine override

Available options:
bayesian,
frequentist
goalMetrics
string[]

Goal metric IDs (defaults to experiment's goal metrics)

secondaryMetrics
string[]

Secondary metric IDs (defaults to experiment's secondary metrics)

guardrailMetrics
string[]

Guardrail metric IDs (defaults to experiment's guardrail metrics)

activationMetric
string

Activation metric ID

dimension
string

Dimension to cut results by

dateStarted
string<date-time>

Analysis start date (ISO 8601)

dateEnded
string<date-time>

Analysis end date (ISO 8601)

regressionAdjustmentEnabled
boolean

Enable CUPED regression adjustment

sequentialTestingEnabled
boolean

Enable sequential testing

sequentialTestingTuningParameter
number

Tuning parameter for sequential testing (frequentist only)

differenceType
enum<string>

How lifts are expressed in results. Defaults to experiment setting.

Available options:
relative,
absolute,
scaled
attributionModel
enum<string>

Metric conversion window attribution model. Defaults to experiment setting.

Available options:
firstExposure,
experimentDuration,
lookbackOverride
lookbackOverride
object

Lookback window when attributionModel is lookbackOverride

metricOverrides
object[]

Per-metric window, risk, and regression-adjustment overrides

customMetricSlices
object[]

Custom metric slice definitions

segment
string

Segment ID to filter users by. Defaults to experiment setting.

queryFilter
string

Raw SQL WHERE clause added to the exposure query. Defaults to experiment setting.

skipPartialData
boolean

When true, exclude users who have not completed the full conversion window.

shareLevel
enum<string>

Visibility of the created report. Defaults to private. Set to public to receive a shareable shareUrl in the response.

Available options:
public,
organization,
private

Response

200 - application/json

Resource created

report
object
required