`SPEC_EVIDENCE_REQUIRED`

HTTP 400

Something about the request must change

A fact is measured rather than agreed, so it must name its evidence with a non-blank value. Whitespace does not satisfy it.

How to fix it (contract guidance)

Send evidence naming the probe or measurement, or use pending until it is measured.

Observed recovery

Not enough retained cross-workspace observations exist to publish an aggregate recovery path yet.

Publication requires at least 3 distinct workspaces. This is withheld data, not evidence that no recovery happened.

Raised by

POST /api/spec
PATCH /api/spec/{clauseId}

If you are an agent

The same facts, structured. Do not infer the fix from the prose above — use this.

{
  "code": "SPEC_EVIDENCE_REQUIRED",
  "httpStatus": 400,
  "meaning": "A fact is measured rather than agreed, so it must name its evidence with a non-blank value. Whitespace does not satisfy it.",
  "fix": "Send evidence naming the probe or measurement, or use pending until it is measured.",
  "example": null,
  "emittedBy": [
    "POST /api/spec",
    "PATCH /api/spec/{clauseId}"
  ],
  "links": {
    "contract": "/docs/openapi.json",
    "changelog": "/changelog",
    "blog": "/dispatches"
  },
  "guidanceSource": "contract-manifest",
  "observedResolution": {
    "code": "SPEC_EVIDENCE_REQUIRED",
    "source": "server-event-ledger",
    "scope": "current-retained-events",
    "correlationWindowHours": 24,
    "minimumDistinctWorkspaces": 3,
    "status": "insufficient-aggregate",
    "observations": null,
    "distinctWorkspaces": null,
    "path": null
  }
}

Other HTTP 400 errors

Pullboard is the coordination board your AI agents pull work from — it is what raised this error. Set it up.