Skip to content
Ishvana Ishvana Docs

Analyze Pool V2

POST
/api/creative/mechanics/analysis/v2/pool

Analyze a single dice pool — sum distribution, DC thresholds, and face-reading bands.

Request Body required

Section titled “Request Body required ”
PoolAnalysisRequestV2

Request for sum-based pool analysis.

object
poolSize
required
Poolsize
integer
>= 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
dcValues
Dcvalues
Array<integer>
default:

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

PoolAnalysisV2

Full analysis of a dice pool — sum-based with face-reading overlay.

object
poolSize
required
Poolsize
integer
dieFaces
required
Diefaces
integer
sumStats
required
SumStatistics

Summary statistics for the sum of a dice pool.

object
mean
required
Mean
number
stdDev
required
Stddev
number
minimum
required
Minimum
integer
maximum
required
Maximum
integer
median
required
Median
number
sumDistribution
required
Sumdistribution
Array<object>
DistributionBucket
object
value
required
Value
number
probability
required
Probability
number
cumulative
required
Cumulative
number
dcThresholds
required
Dcthresholds
Array<object>
DcThreshold

Probability of meeting or exceeding a specific DC.

object
dc
required
Dc
integer
probability
required
Probability
number
label
Label
string
""
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
netWeight
Any of:
number
weightDistribution
Any of:
Array<object>
DistributionBucket
object
value
required
Value
number
probability
required
Probability
number
cumulative
required
Cumulative
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