Warnings & score - Diagrams.so

Generate, edit, and fix responses include a score and a list of warnings, a lightweight Well-Architected review of the design.

{
  "score": {
    "score": 78,
    "tier": "good",
    "warning_count": 2,
    "recoverable_points": 22,
    "breakdown": [
      { "type": "no_encryption_transit", "label": "No encryption in transit", "count": 1, "deduction": 15 }
    ]
  },
  "warnings": [
    { "type": "reliability", "component": "S3", "message": "Enable versioning on the bucket." },
    { "type": "security", "component": "ALB", "message": "Terminate TLS at the load balancer." }
  ]
}

Field	Meaning
`score.score`	Overall design score from 0 to 100.
`score.tier`	Rating band, such as `fair`, `good`, or `excellent`.
`score.recoverable_points`	Points you can regain by fixing the findings.
`score.breakdown[]`	Per-issue deductions (`type`, `label`, `count`, `deduction`).
`warnings[].type`	Pillar, such as `reliability`, `security`, `cost`, `performance`, or `operations`.
`warnings[].component`	The component the finding applies to.
`warnings[].message`	What to change.

Get warnings on demand

GET /diagrams/{id}/warnings re-reads the current findings.

Fix a warning

POST /diagrams/{id}/fix applies a change for one finding. Pass its message, and optionally component and warning_type. The response returns the updated diagram with a refreshed score (xml is null on Free). See Diagrams.