API reference

Base URL

https://writingsystem.bowtiekreative.com

No key, no rate limit headers, CORS open to any origin. If you are building on this, pin the corpus version — 1.0.0 — from /v1/health.

Endpoints

Meta

Corpus

Engine

POST /v1/evaluate

Analyses the text, selects the rules that apply, and evaluates each against every unit of its layer.

curl -X POST https://writingsystem.bowtiekreative.com/v1/evaluate \
  -H 'content-type: application/json' \
  -d '{
    "text": "The committee reviewed the report, it was approved without discussion.",
    "profile": "PROFILE-GENERAL",
    "context": { "genre": "report", "stakes": "medium" },
    "facts": { "claim": { "type": "causal" } }
  }'

What comes back

verdict

blocked when a hard constraint demands a change, otherwise clear.

blocking

Hard constraints that fired and require an edit.

context_defaults

Apply unless you can name the exception.

ranked_options

Heuristics and creative options — scored, never forced.

checks

Rules asking you to verify or supply context rather than edit.

needs_input

Evaluations the engine refused to guess, with the exact fact paths required.

coverage

How many rules were selected, evaluated, resolved and left open.

test_plan

The regression dimensions and corpus cases to re-check after editing.

Derived facts versus facts you supply

Rule conditions read named facts. The analyser derives 80 of them from raw text — sentence length, voice, clause counts, readability, punctuation structure. The rules read 371 distinct paths in total. The rest are semantic: whether a claim is causal, whether evidence is sufficient, what effect a sentence intends.

See every derived and required path →

POST /v1/score

Scores you supply, 0–4, against the twelve weighted metrics. Four gate metrics fail the document regardless of the average.

curl -X POST https://writingsystem.bowtiekreative.com/v1/score \
  -H 'content-type: application/json' \
  -d '{ "scores": { "accuracy": 3, "clarity": 3, "usability": 2, "evidence": 3, "accessibility": 3, "ethics": 4 } }'

The metric model →

POST /v1/resolve

Which rules govern a context, before you write a word. Returns the active set, the precedence order and the selection policy.

curl -X POST https://writingsystem.bowtiekreative.com/v1/resolve \
  -H 'content-type: application/json' \
  -d '{ "profile": "PROFILE-TECH" }'