Skip to main content

Documentation Index

Fetch the complete documentation index at: https://wuweism.com/llms.txt

Use this file to discover all available pages before exploring further.

Wu-Weism enforces scientific integrity at the API layer. The integrity endpoints let you inspect how your causal reasoning is holding up against the constraints of your registered SCMs, submit formal signoffs to your institutional record, and pull audit reports that trace alignment over time.
All endpoints on this page require authentication. Include your session token in the Authorization header.

​
Get integrity dashboard

GET /api/scm/integrity/dashboard
Returns an aggregated integrity status for your account’s SCM usage. Use this to monitor whether your causal analyses are consistent with the structural constraints of your registered models — for example, whether your adjustment sets satisfy back-door criteria, or whether you have unresolved confounder warnings.

​
Response fields

​
success
boolean
required
true when the request succeeds.
​
status
string
required
Overall integrity status. One of "healthy", "warnings", or "violations".
​
summary
object
required
Counts of integrity events.
​
recentEvents
object[]
required
List of recent integrity events, most recent first.

​
Example

curl --request GET \
  --url https://wuweism.com/api/scm/integrity/dashboard \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "status": "warnings",
  "summary": {
    "totalAnalyses": 42,
    "constraintViolations": 0,
    "openWarnings": 3,
    "signoffsPending": 1
  },
  "recentEvents": [
    {
      "eventId": "e1a2b3c4-0001-4abc-9def-000000000001",
      "modelKey": "neural_topology_v1",
      "eventType": "warning",
      "message": "Adjustment set does not include all required confounders identified by the SCM. Missing: ['age'].",
      "timestamp": "2026-04-03T09:14:22Z"
    },
    {
      "eventId": "e1a2b3c4-0001-4abc-9def-000000000002",
      "modelKey": "alignment_bias_scm",
      "eventType": "audit_pass",
      "message": "Intervention validated. Back-door criterion satisfied.",
      "timestamp": "2026-04-02T16:45:00Z"
    }
  ]
}

​
Submit a scientific integrity signoff

POST /api/scm/integrity/signoff
Submit a formal scientific integrity signoff for a specific model version. Signoffs record that you have reviewed the causal assumptions and constraint compliance for an analysis and attest to its validity. Signoffs are appended to your account’s integrity ledger and are immutable.

​
Request body

​
modelKey
string
required
The SCM you are signing off on.
​
version
string
required
The model version you are signing off on (e.g., "1.0.0").
​
signoffNote
string
Optional free-text note explaining the basis for your signoff. Recommended for institutional records.

​
Response fields

​
success
boolean
required
true when the signoff is recorded.
​
signoffId
string
required
UUID of the created signoff record. Store this if you need to reference the signoff in downstream systems.
​
timestamp
string
required
ISO 8601 timestamp at which the signoff was recorded.

​
Example

curl --request POST \
  --url https://wuweism.com/api/scm/integrity/signoff \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "modelKey": "neural_topology_v1",
    "version": "1.0.0",
    "signoffNote": "Reviewed back-door criterion compliance for cortisol → hippocampal_volume pathway. Adjustment set confirmed sufficient."
  }'

{
  "success": true,
  "signoffId": "sf-9a3e1b72-cc4d-4f1a-b802-d6e7f3a0c291",
  "timestamp": "2026-04-05T11:08:33Z"
}

​
Get alignment audit reports

GET /api/scm/alignment-audit
Returns alignment audit reports for your account. Each report summarises how your causal reasoning over a given period held up against the structural constraints of your SCMs — including which constraints were satisfied, which were violated, and how reasoning drifted or improved over time. Alignment audit reports are generated automatically by Wu-Weism on a rolling basis as you use the platform.

​
Response fields

​
success
boolean
required
true when the request succeeds.
​
reports
object[]
required
List of audit reports, most recent first.

​
Example

curl --request GET \
  --url https://wuweism.com/api/scm/alignment-audit \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "reports": [
    {
      "reportId": "ar-4f2e9c10-bb3a-4d8e-a917-c1d0f2b3e456",
      "periodStart": "2026-03-01T00:00:00Z",
      "periodEnd": "2026-03-31T23:59:59Z",
      "modelsAudited": ["neural_topology_v1", "alignment_bias_scm"],
      "alignmentScore": 0.91,
      "constraintCompliance": {
        "back_door_criterion": 0.95,
        "acyclicity": 1.0,
        "no_unmeasured_confounding": 0.87
      },
      "drift": "improving",
      "generatedAt": "2026-04-01T02:00:00Z"
    },
    {
      "reportId": "ar-1a0b8d22-ff1c-4e9a-b055-a2c3d4e5f678",
      "periodStart": "2026-02-01T00:00:00Z",
      "periodEnd": "2026-02-28T23:59:59Z",
      "modelsAudited": ["neural_topology_v1"],
      "alignmentScore": 0.84,
      "constraintCompliance": {
        "back_door_criterion": 0.88,
        "acyclicity": 1.0,
        "no_unmeasured_confounding": 0.79
      },
      "drift": "stable",
      "generatedAt": "2026-03-01T02:00:00Z"
    }
  ]
}