Developer

API reference

A Studio subscription gives you programmatic access to the same audit engine that powers the web interface. Use it to integrate argument auditing into your CMS, editorial pipeline, or research tooling.

Authentication

Generate an API key from your account page. Keys are prefixed wsk_live_ and must be passed as a Bearer token on every request.

Authorization: Bearer wsk_live_<your-key>

Keys inherit the rate limits of your subscription tier (200 audits/day).

POST /api/audit

Run a full structural audit on a piece of text or a URL.

Request body (JSON)

{
  "text": "Your argument text here…"
}

// OR pass a public URL:
{
  "url": "https://example.com/article"
}

Example (curl)

curl -X POST https://thewhetstone.review/api/audit \
  -H "Authorization: Bearer wsk_live_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{"text": "All politicians lie, therefore no policy can be trusted."}'

Success response (200)

{
  "ok": true,
  "audit": {
    "summary": "…",
    "toulmin": { … },
    "fallacies": [ … ],
    "loadedLanguage": [ … ],
    "unstatedWarrants": [ … ],
    "keyTermScrutiny": [ … ],
    "referentCheck": [ … ],
    "falsifiabilityCheck": [ … ]
  },
  "usage": {
    "inputTokens": 320,
    "outputTokens": 840
  }
}

Error responses

Status	Code	Meaning
401	-	Missing or invalid API key
400	INVALID_INPUT	Text too short (<50 chars), too long (>10,000 chars), or no text/url provided
429	RATE_LIMITED	Daily audit limit reached; resets at midnight UTC
503	AUDIT_FAILED	Upstream LLM temporarily unavailable; retry with backoff

Key management

Keys are managed from your account page. You can have up to 10 active keys. Revoking a key is immediate and irreversible - any integration using it will receive 401 responses.

Plaintext keys are shown exactly once at creation. If you lose a key, revoke it and generate a new one.

Rate limits

API key requests share the same daily quota as your browser session (200 audits/day on the Solo tier). The quota resets at midnight UTC. If you need a higher limit, contact us.

No subscription yet? View pricing →