Validate BRAIN.md

from prysm import Prysm

client = Prysm()
print(client.validate_brain(open("BRAIN.md").read()))

import { Prysm } from "@prysmai/sdk";
import { readFileSync } from "node:fs";

const client = new Prysm();
console.log(await client.validateBrain(readFileSync("BRAIN.md", "utf-8")));

curl -X POST https://api.prysm1.com/v1/brain/validate \
  -H "Content-Type: application/json" \
  -d '{"brain_md": "max_cost_per_request: 0.005\nrules:\n  - when: code\n    model: deepseek-v4-flash\n"}'

{
  "valid": true,
  "errors": [],
  "warnings": [],
  "normalized": {
    "max_cost": 0.005,
    "rules": [{ "when": "code", "model": "deepseek-v4-flash" }]
  }
}

{
  "valid": false,
  "errors": ["unknown model in rule: ghost-model"],
  "warnings": [],
  "normalized": { "rules": [] }
}

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:

string

Raw BRAIN.md text (YAML with Markdown affordances).

object

An already-parsed config object (alternative to brain_md).

Response

boolean

true if and only if errors is empty.

string[]

Blocking problems: unknown locked model, unknown rule model, non-positive max_cost.

string[]

Advisory issues: unknown blocked/fallback model; every fallback also blocked.

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()))

import { Prysm } from "@prysmai/sdk";
import { readFileSync } from "node:fs";

const client = new Prysm();
console.log(await client.validateBrain(readFileSync("BRAIN.md", "utf-8")));

curl -X POST https://api.prysm1.com/v1/brain/validate \
  -H "Content-Type: application/json" \
  -d '{"brain_md": "max_cost_per_request: 0.005\nrules:\n  - when: code\n    model: deepseek-v4-flash\n"}'

{
  "valid": true,
  "errors": [],
  "warnings": [],
  "normalized": {
    "max_cost": 0.005,
    "rules": [{ "when": "code", "model": "deepseek-v4-flash" }]
  }
}

{
  "valid": false,
  "errors": ["unknown model in rule: ghost-model"],
  "warnings": [],
  "normalized": { "rules": [] }
}

List models BRAIN.md Sharing

Overview

Endpoints

Agentic Control Plane

Agentic Control Plane

Validate BRAIN.md

Body

Response

​Body

​Response

Body

Response