Skip to main content
POST
Run power analysis

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Path Parameters

division_id
string
required

Division whose completed episodes should be analyzed.

Pattern: ^div_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Body

application/json
policy_ref
string | null

Policy version UUID or name:vN label to use as the analysis anchor.

elo_grid
number[]

Elo differences for which to estimate required sample sizes.

Minimum array length: 1
alpha
number
default:0.05

Two-sided false-positive rate.

Required range: 0.000001 <= x <= 0.999999
power
number
default:0.8

Target probability of detecting an effect.

Required range: 0.000001 <= x <= 0.999999
max_episodes
integer
default:1000

Maximum recent completed episodes to scan.

Required range: 1 <= x <= 5000

Response

Successful Response

division_id
string
required

Division whose history was analyzed.

anchor
PowerAnalysisAnchor · object | null
required

Resolved policy anchor, or null for population analysis.

note
string | null
required

Explanation when the requested analysis is limited or unavailable.

window
PowerAnalysisWindow · object
required

Completed-round history included in the analysis.

mode_mix
PowerAnalysisModeMix · object
required

Gameplay-mode distribution used for blended estimates.

modes
Modes · object
required

Outcome estimates keyed by gameplay mode.

league_pooled
League Pooled · object
required

League-wide fallback estimates keyed by gameplay mode.

table
PowerAnalysisTableRow · object[]
required

Required sample sizes for each requested Elo difference.