Skip to content

Forge Stats

POST
/api/creative/gamemaster/forge-stats

Run the archetype forge. Optionally persist + link to a Legendry entry.

persist
Persist
boolean
linked_entry_id
Linked Entry Id
string
""
ForgeRequest

Incoming request to the archetype forge.

The legacy /generate-stats endpoint maps its arguments onto a forge request with a sensible-default archetype. New consumers (the Forge UI tab) pass the fields directly.

object
archetypeId
required
Archetypeid
string
>= 1 characters
rulesetRef
required
Rulesetref
string
>= 1 characters
projectId
required
Projectid
string
>= 1 characters
level
Level
integer
default: 1 >= 1 <= 30
backgroundEntryId
Backgroundentryid
string
""
speciesEntryId
Speciesentryid
string
""
seed
Seed
string
""
variance
Variance
number
default: 0.3 <= 1
lockedFields
Lockedfields
Array<string>
lockedValues
Lockedvalues
object
key
additional properties
number

Successful Response

ForgeResponse

Wrapper including the persisted record id when the forge was saved.

object
success
Success
boolean
default: true
forged
required
ForgedStatBlock

Deterministic output of the forge pipeline.

All stats clamp to the ruleset’s declared bounds; derived stats are evaluated via SafeFormulaEvaluator after jitter and locks apply.

object
archetypeId
required
Archetypeid
string
rulesetRef
required
Rulesetref
string
projectId
required
Projectid
string
level
required
Level
integer
seedUsed
required
Seedused
string
variance
required
Variance
number
stats
required
Stats
object
key
additional properties
number
derived
required
Derived
object
key
additional properties
number
features
Features
Array<string>
gear
Gear
Array<string>
spellSlots
Spellslots
object
key
additional properties
integer
generationNotes
Generationnotes
Array<string>
persistenceId
Persistenceid
string
""
error
Any of:
string

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