Bow Tie Kreative Digital StemCell
Explorer

Reference

API reference

Base URL https://api.digitalstemcell.bowtiekreative.com. Every endpoint is public — no key, no signup. Responses are JSON and carry Cache-Control: public, max-age=3600. The authoritative machine-readable contract is the OpenAPI 3.1 document.

GET

/v1

Service index: version, counts and the endpoint listing.

curl https://api.digitalstemcell.bowtiekreative.com/v1
GET

/v1/health

Liveness check. Returns the loaded coordinate count.

curl https://api.digitalstemcell.bowtiekreative.com/v1/health
GET

/llms.txt

Plain-text agent guide: what the grammar is, every route, and the typical flow.

curl https://api.digitalstemcell.bowtiekreative.com/llms.txt
GET

/v1/axes

All three axes in one document, with the origin note and the illustrative-state warning.

curl https://api.digitalstemcell.bowtiekreative.com/v1/axes
GET

/v1/axes/{axis}

One axis on its own.

Parameters for GET /v1/axes/{axis}
NameInRequiredDescription
axispathrequiredOne of change-levels, internal-variables, meta-variables.
 
curl https://api.digitalstemcell.bowtiekreative.com/v1/axes/meta-variables
Error responses for GET /v1/axes/{axis}
StatusWhen
404The axis name is not one of the three.
GET

/v1/grid

The 50-cell grid pairing each change level with each internal variable, and the intent of that pairing.

Parameters for GET /v1/grid
NameInRequiredDescription
changequeryoptionalChange level code, e.g. C3.
internalqueryoptionalInternal variable code, e.g. I07.
 
curl 'https://api.digitalstemcell.bowtiekreative.com/v1/grid?change=C3&internal=I07'
GET

/v1/coordinates/{code}

Resolve a full coordinate into its three axis definitions, the grid intent and the prompt stem.

Parameters for GET /v1/coordinates/{code}
NameInRequiredDescription
codepathrequiredA coordinate id of the form LAKA-C3-I07-M08.
 
curl https://api.digitalstemcell.bowtiekreative.com/v1/coordinates/LAKA-C3-I07-M08
Error responses for GET /v1/coordinates/{code}
StatusWhen
422The code is malformed. Change is C0–C4, internal is I01–I10, meta is M01–M14.
GET

/v1/prompts

Search and page the 700 prompt stems. Filters combine with AND.

Parameters for GET /v1/prompts
NameInRequiredDescription
qqueryoptionalFree-text search across the prompt stem and the id.
changequeryoptionalChange level code, e.g. C2.
internalqueryoptionalInternal variable code, e.g. I07.
metaqueryoptionalMeta-variable code, e.g. M08.
limitqueryoptional1–700. Defaults to 50.
offsetqueryoptionalZero-based. Defaults to 0.
 
curl 'https://api.digitalstemcell.bowtiekreative.com/v1/prompts?change=C2&internal=I07&limit=5'
GET

/v1/prompts/{id}

One prompt stem by coordinate id.

Parameters for GET /v1/prompts/{id}
NameInRequiredDescription
idpathrequiredCoordinate id, e.g. LAKA-C0-I01-M01.
 
curl https://api.digitalstemcell.bowtiekreative.com/v1/prompts/LAKA-C0-I01-M01
Error responses for GET /v1/prompts/{id}
StatusWhen
404No prompt stem carries that id.
GET

/v1/modes

The six operating modes plus the overview table as Markdown.

curl https://api.digitalstemcell.bowtiekreative.com/v1/modes
GET

/v1/modes/{id}

One mode playbook as Markdown.

Parameters for GET /v1/modes/{id}
NameInRequiredDescription
idpathrequiredDECODE, GENERATE, PLAN, POSITION, PREDICT or SOLVE.
 
curl https://api.digitalstemcell.bowtiekreative.com/v1/modes/PREDICT
Error responses for GET /v1/modes/{id}
StatusWhen
404Unknown mode name.
GET

/v1/operators

The seventeen operators with definition, input, output, guardrail and example.

Parameters for GET /v1/operators
NameInRequiredDescription
categoryqueryoptionalNavigation, Transformation, Relationship, Control, Composition, Comparison or Selection.
 
curl 'https://api.digitalstemcell.bowtiekreative.com/v1/operators?category=Transformation'
GET

/v1/operators/{name}

One operator. Case-insensitive.

Parameters for GET /v1/operators/{name}
NameInRequiredDescription
namepathrequirede.g. INVERT.
 
curl https://api.digitalstemcell.bowtiekreative.com/v1/operators/INVERT
Error responses for GET /v1/operators/{name}
StatusWhen
404Unknown operator name.
GET

/v1/core

The seven core framework extracts, listed by id and title.

curl https://api.digitalstemcell.bowtiekreative.com/v1/core
GET

/v1/core/{id}

One core extract as Markdown.

Parameters for GET /v1/core/{id}
NameInRequiredDescription
idpathrequirede.g. formal-grammar.
 
curl https://api.digitalstemcell.bowtiekreative.com/v1/core/formal-grammar
Error responses for GET /v1/core/{id}
StatusWhen
404Unknown extract id.
GET

/v1/templates

The five working templates, listed by id and title.

curl https://api.digitalstemcell.bowtiekreative.com/v1/templates
GET

/v1/templates/{id}

One template as Markdown.

Parameters for GET /v1/templates/{id}
NameInRequiredDescription
idpathrequiredrun-laka, worksheet, concept-card, forecast-ledger or strategy-and-positioning.
 
curl https://api.digitalstemcell.bowtiekreative.com/v1/templates/run-laka
Error responses for GET /v1/templates/{id}
StatusWhen
404Unknown template id.
GET

/v1/schema/run

The JSON Schema (2020-12) a run document must satisfy.

curl https://api.digitalstemcell.bowtiekreative.com/v1/schema/run
GET

/v1/schema/blank-run

An empty, schema-valid run document to fill in.

curl https://api.digitalstemcell.bowtiekreative.com/v1/schema/blank-run
GET

/v1/scoring

The seven weighted criteria, the four hard gates, the rating anchors and the formula.

curl https://api.digitalstemcell.bowtiekreative.com/v1/scoring
POST

/v1/score

Weight a set of 0–4 ratings into a 0–100 comparison index, with the per-criterion contribution shown.

Parameters for POST /v1/score
NameInRequiredDescription
ratingsbodyrequiredObject mapping every criterion id to an integer 0–4.
hard_gates_passedbodyoptionalBoolean. Omit or send null when unknown — the result is then held for investigation.
 
curl -X POST https://api.digitalstemcell.bowtiekreative.com/v1/score \
  -H 'content-type: application/json' \
  -d '{
    "ratings": {
      "outcome_contribution": 3, "feasibility": 2, "evidence": 2,
      "adoption": 3, "differentiation": 4, "reversible_learning": 3,
      "robustness": 2
    },
    "hard_gates_passed": true
  }'
Error responses for POST /v1/score
StatusWhen
422A criterion is missing, unknown, or a rating falls outside 0–4.
POST

/v1/validate

Validate a run document against the run schema. Returns every error with its JSON path.

Parameters for POST /v1/validate
NameInRequiredDescription
(body)bodyrequiredThe run document to validate.
 
curl -X POST https://api.digitalstemcell.bowtiekreative.com/v1/validate \
  -H 'content-type: application/json' \
  -d '{"run_id":"demo","mode":"GENERATE"}'