Skip to main content
POST https://api.prysm1.com/v1/brain/validate · No authentication required
Validate a BRAIN.md before you ship it. Returns whether it’s valid, any blocking errors, advisory warnings, and the normalized config PRYSM’s router consumes.

Body

Provide one of the following:
brain_md
string
Raw BRAIN.md text (YAML with Markdown affordances).
brain_config
object
An already-parsed config object (alternative to brain_md).

Response

valid
boolean
true if and only if errors is empty.
errors
string[]
Blocking problems: unknown locked model, unknown rule model, non-positive max_cost.
warnings
string[]
Advisory issues: unknown blocked/fallback model; every fallback also blocked.
normalized
object
The canonical config PRYSM’s router consumes (e.g. max_cost_per_request normalized to max_cost, signal aliases resolved).
from prysm import Prysm

client = Prysm()
print(client.validate_brain(open("BRAIN.md").read()))
{
  "valid": true,
  "errors": [],
  "warnings": [],
  "normalized": {
    "max_cost": 0.005,
    "rules": [{ "when": "code", "model": "deepseek-v3.2" }]
  }
}