Skip to content
Ishvana Ishvana Docs

Power Curve

POST
/api/creative/mechanics/analysis/power-curve

Compute pool analysis across a range of pool sizes (weight-based).

Request Body required

Section titled “Request Body required ”
PowerCurveRequest

Request for power curve across pool sizes.

object
minPool
Minpool
integer
default: 1 >= 1 <= 50
maxPool
Maxpool
integer
default: 10 >= 1 <= 50
outcomeMapping
required
DiceOutcomeMapping

Defines how individual die faces map to categorical outcomes.

For a d10 pool system: faces 1-10 map to bands like Critical Success, Advantage, Neutral, Consequence, Critical Failure — each with a weight that determines net outcome when advantages and consequences cancel.

object
dieFaces
required
Diefaces
integer
>= 2 <= 100
bands
required
Bands
Array<object>
>= 1 items
DiceOutcomeBand

A range of die face values with a categorical meaning and weight.

Example: on a d10, faces 8-9 are “Advantage” with weight +1.

object
name
required
Name
string
>= 1 characters <= 50 characters
minValue
required
Minvalue
integer
>= 1
maxValue
required
Maxvalue
integer
>= 1
weight
Weight
integer
0
color
Color
string
default: #6b7280

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Response Power Curve Api Creative Mechanics Analysis Power Curve Post
Array<object>
PoolAnalysis

Full probability analysis of a dice pool with outcome mapping.

object
poolSize
required
Poolsize
integer
bandExpectations
required
Bandexpectations
Array<object>
BandExpectation

Expected outcome for a single band in a dice pool.

object
bandName
required
Bandname
string
expectedCount
required
Expectedcount
number
probability
required
Probability
number
weight
required
Weight
integer
color
required
Color
string
expectedNet
required
Expectednet
number
netStdDev
required
Netstddev
number
netDistribution
required
Netdistribution
Array<object>
DistributionBucket
object
value
required
Value
number
probability
required
Probability
number
cumulative
required
Cumulative
number
positiveProb
required
Positiveprob
number
negativeProb
required
Negativeprob
number
zeroProb
required
Zeroprob
number

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object