Compose Ability

POST

/api/creative/mechanics/ability-workshop/compose

• DivinityEngine - Local development
• DivinityEngine - Localhost alternative

Build a draft + balance report from author-supplied components.

Request Body ^required

ComposeRequest

object

projectId

required

Projectid

string

rulesetRef

required

Rulesetref

string

components

required

AbilityComponents

Full component tree for one ability.

object

target

TargetComponent

object

kind

Kind

string

default: single_enemy

Allowed values: self single_ally single_enemy area_sphere area_cube area_line area_cone chain touch

range

RangeComponent

object

value

Value

integer

default: 30 <= 100000

unit

Unit

string

default: ft

scalesWithLevel

Scaleswithlevel

boolean

special

Special

string

""

cost

CostComponent

object

resource

Resource

string

default: action

amount

Amount

integer

default: 1 <= 1000

alternate

Alternate

string

""

effect

EffectComponent

object

kind

Kind

string

default: damage

Allowed values: damage heal control buff debuff summon movement utility

magnitude

Magnitude

string

default: 1d6

scalingFormulaRef

Scalingformularef

string

""

elementalTag

Elementaltag

string

""

secondary

Secondary

Array<string>

duration

DurationComponent

object

kind

Kind

string

default: instant

Allowed values: instant 1_round n_rounds scene stance concentration permanent

rounds

Rounds

integer

0

repeatTrigger

Repeattrigger

string

""

save

SaveComponent

object

stat

Stat

string

""

dcFormula

Dcformula

string

""

partialEffect

Partialeffect

string

default: no_effect

Allowed values: no_effect half specified_reduction

specifiedReduction

Specifiedreduction

string

""

tags

TagsComponent

Boolean flags for ability metadata tags.

object

stealth

Stealth

boolean

loud

Loud

boolean

visible

Visible

boolean

ritual

Ritual

boolean

materialComponent

Materialcomponent

boolean

verbal

Verbal

boolean

somatic

Somatic

boolean

reactionTrigger

Reactiontrigger

boolean

concentration

Concentration

boolean

areaSelectable

Areaselectable

boolean

lineOfSightRequired

Lineofsightrequired

boolean

default: true

metadata

AbilityMetadata

object

name

Name

string

""

flavorDescription

Flavordescription

string

""

sourceArchetype

Sourcearchetype

string

""

schoolOrTradition

Schoolortradition

string

""

rarity

Rarity

string

default: common

Allowed values: common uncommon rare legendary

tier

Tier

integer

default: 1 <= 10

tier

Tier

integer

default: 1

Responses

200

Successful Response

ComposeResponse

object

success

Success

boolean

default: true

draft

required

AbilityDraft

In-progress ability (pre-save) — components + name + flavor.

object

components

AbilityComponents

Full component tree for one ability.

object

target

TargetComponent

object

kind

Kind

string

default: single_enemy

Allowed values: self single_ally single_enemy area_sphere area_cube area_line area_cone chain touch

range

RangeComponent

object

value

Value

integer

default: 30 <= 100000

unit

Unit

string

default: ft

scalesWithLevel

Scaleswithlevel

boolean

special

Special

string

""

cost

CostComponent

object

resource

Resource

string

default: action

amount

Amount

integer

default: 1 <= 1000

alternate

Alternate

string

""

effect

EffectComponent

object

kind

Kind

string

default: damage

Allowed values: damage heal control buff debuff summon movement utility

magnitude

Magnitude

string

default: 1d6

scalingFormulaRef

Scalingformularef

string

""

elementalTag

Elementaltag

string

""

secondary

Secondary

Array<string>

duration

DurationComponent

object

kind

Kind

string

default: instant

Allowed values: instant 1_round n_rounds scene stance concentration permanent

rounds

Rounds

integer

0

repeatTrigger

Repeattrigger

string

""

save

SaveComponent

object

stat

Stat

string

""

dcFormula

Dcformula

string

""

partialEffect

Partialeffect

string

default: no_effect

Allowed values: no_effect half specified_reduction

specifiedReduction

Specifiedreduction

string

""

tags

TagsComponent

Boolean flags for ability metadata tags.

object

stealth

Stealth

boolean

loud

Loud

boolean

visible

Visible

boolean

ritual

Ritual

boolean

materialComponent

Materialcomponent

boolean

verbal

Verbal

boolean

somatic

Somatic

boolean

reactionTrigger

Reactiontrigger

boolean

concentration

Concentration

boolean

areaSelectable

Areaselectable

boolean

lineOfSightRequired

Lineofsightrequired

boolean

default: true

metadata

AbilityMetadata

object

name

Name

string

""

flavorDescription

Flavordescription

string

""

sourceArchetype

Sourcearchetype

string

""

schoolOrTradition

Schoolortradition

string

""

rarity

Rarity

string

default: common

Allowed values: common uncommon rare legendary

tier

Tier

integer

default: 1 <= 10

balance

required

BalanceReport

object

powerLevel

required

Powerlevel

number

tierBaselineMin

required

Tierbaselinemin

number

tierBaselineMax

required

Tierbaselinemax

number

verdict

required

Verdict

string

Allowed values: green yellow red

warnings

Warnings

Array<object>

BalanceWarning

A heuristic warning surfaced by the balance validator.

object

ruleId

required

Ruleid

string

message

required

Message

string

severity

Severity

string

default: warning

Allowed values: info warning error

appliedFormula

Appliedformula

string

""

error

Any of:

string

string

null

null

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