BRAIN.md Sharing

POST /v1/brain/share requires a Bearer token. GET /v1/b/{id} is public — no key needed.

A shared BRAIN.md is a living snapshot of your routing config: model preference, cost ceiling, signal-based rules, blocked models. Share it in a blog post, Discord message, or README badge — anyone (including other agents) can fetch it without an API key. Invalid configs are shareable too, so the community can help you debug.

Create a shareable link for a BRAIN.md config.

POST https://api.prysm1.com/v1/brain/share · Auth required

Request Body

string

Raw BRAIN.md text to share. Accepts the same YAML format as /v1/brain/validate.

object

Pre-parsed config dict (alternative to brain_md).

string

Optional human-readable label shown on the share page (max 120 chars).

Response

string

brain.share

Unique ID for this share (prysm1.com/b/{share_id}).

string

Full API URL to retrieve the config: https://api.prysm1.com/v1/b/{share_id}.

string

Marketing short URL: https://prysm1.com/b/{share_id}.

string | null

Echoed title, or null if not provided.

object

Normalized config object (the canonical form, regardless of which input format was used).

boolean

Whether the config passed validation.

string[]

Validation errors (empty if valid).

curl -X POST https://api.prysm1.com/v1/brain/share \
  -H "Authorization: Bearer prysm_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "brain_md": "model: deepseek-v3.2\nmax_cost_per_request: 0.05\n",
    "title": "My cost-safe dev config"
  }'

import prysm

share = prysm.brain.share(
    brain_md="model: deepseek-v3.2\nmax_cost_per_request: 0.05\n",
    title="My cost-safe dev config",
)
print(share["short_url"])   # https://prysm1.com/b/abc123def456

{
  "object": "brain.share",
  "share_id": "abc123def456",
  "url": "https://api.prysm1.com/v1/b/abc123def456",
  "short_url": "https://prysm1.com/b/abc123def456",
  "title": "My cost-safe dev config",
  "config": {
    "model": "deepseek-v3.2",
    "max_cost_per_request": 0.05
  },
  "valid": true,
  "errors": []
}

GET /v1/b/

Retrieve a shared BRAIN.md config by its short ID. No API key required.

GET https://api.prysm1.com/v1/b/{share_id} · Public

The short ID returned by POST /v1/brain/share.

Response

string

brain.share

The share ID.

string | null

Label set by the sharer.

object

Normalized BRAIN.md config.

string | null

Original BRAIN.md text (if shared as text).

number

Unix timestamp of when the share was created.

curl https://api.prysm1.com/v1/b/abc123def456

import httpx

share = httpx.get("https://api.prysm1.com/v1/b/abc123def456").json()
print(share["config"]["model"])   # deepseek-v3.2

{
  "object": "brain.share",
  "share_id": "abc123def456",
  "title": "My cost-safe dev config",
  "config": {
    "model": "deepseek-v3.2",
    "max_cost_per_request": 0.05
  },
  "brain_md": "model: deepseek-v3.2\nmax_cost_per_request: 0.05\n",
  "created_at": 1750017000.0
}

{"error": "share_not_found", "message": "No shared BRAIN.md with id 'abc123def456'."}

GET /v1/brain/shares

List BRAIN.md configs you have shared, newest first.

GET https://api.prysm1.com/v1/brain/shares · Auth required

Returns {object: "list", data: [{share_id, title, config, url, short_url, created_at}...]}.

GET /v1/brain/badge

Generate an SVG badge for embedding in a README or docs page.

GET https://api.prysm1.com/v1/brain/badge · Public · Cacheable 1h

string

A PRYSM model ID (e.g. deepseek-v3.2). The badge value becomes the model’s display name, colored by tier: budget=green, mid=amber, premium=indigo, frontier=violet.

string

Override the left label. Default: BRAIN.md.

Embed in your README:

[![BRAIN.md](https://api.prysm1.com/v1/brain/badge?model=deepseek-v3.2)](https://prysm1.com/b/YOUR_SHARE_ID)

The badge links to your shared config so any developer (or agent) can inspect your routing rules.

Overview

Endpoints

Agentic Control Plane

Agentic Control Plane

BRAIN.md Sharing

Request Body

Response

GET /v1/b/

Response

GET /v1/brain/shares

GET /v1/brain/badge

​POST /v1/brain/share

​Request Body

​Response

​GET /v1/b/

​Response

​GET /v1/brain/shares

​GET /v1/brain/badge

POST /v1/brain/share

Request Body

Response

GET /v1/b/

Response

GET /v1/brain/shares

GET /v1/brain/badge