Explain what happened in a research Run
GET
/v1/runs/{runId}/diagnosticsOne owner-scoped answer composed from what was recorded: the request and plan, sources, cells, reconciliation, completion, and cost and timing. Each area separates observations (recorded facts), findings (derived by fixed rules), and unknowns (what was not recorded). Nothing is inferred from absence; Runs before recording existed report unknowns rather than guesses. Read-only.
Authorization
apiKey AuthorizationBearer <token>
API key shown once at creation and stored as a SHA-256 hash.
In: header
Path Parameters
runId*string
Format
uuidQuery Parameters
summary?boolean
Add Run-wide loss groups; true cannot be combined with entity or field.
entity?string
Exact recorded entity name; adds a connected diagnosis.
Length
1 <= length <= 200field?string
Field ID or exact label; requires entity.
Length
1 <= length <= 200Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/diagnostics"{ "diagnostics": { "entity": { "entity": "string", "basis": "recorded", "attemptId": "string", "matchedNames": [ "string" ], "outcome": "present", "field": "string", "entityFacts": [ { "stage": "discovery", "code": "string", "detail": "string", "evidenceId": "string", "failure": true } ], "cells": [ { "rowId": "string", "fieldId": "string", "value": null, "missingReason": "string", "evidenceIds": [ "string" ] } ], "paths": [ { "url": "string", "facts": [ { "stage": "discovery", "code": "string", "detail": "string", "evidenceId": "string", "failure": true } ], "unknownStages": [ "discovery" ], "firstFailure": { "stage": "discovery", "code": "string", "detail": "string", "evidenceId": "string", "failure": true } } ], "firstFailures": [ { "code": "string", "urls": [ "string" ] } ], "recovered": true, "peers": [ { "entity": "string", "codes": [ "string" ], "outcome": "present" } ], "unknowns": [ "string" ] }, "summary": { "basis": "recorded", "attemptId": "string", "outputComplete": true, "totals": { "present": 0, "absent": 0, "unknown": 0, "ambiguous": 0, "recovered": 0, "entities": 0 }, "entities": [ { "entity": "string", "aliases": [ "string" ], "outcome": "present", "recovered": true, "failureCodes": [ "string" ] } ], "failureGroups": [ { "stage": "discovery", "code": "string", "detail": "string", "counts": { "present": 0, "absent": 0, "unknown": 0, "ambiguous": 0, "recovered": 0 }, "examples": [ { "entity": "string", "evidenceId": "string", "url": "string" } ] } ], "duplicates": { "entities": 0, "examples": [ { "entity": "string", "code": "string", "evidenceId": "string" } ] }, "missingCells": [ { "fieldId": "string", "label": "string", "observedRows": 0, "missing": 0, "reasons": { "property1": 0, "property2": 0 }, "examples": [ { "entity": "string", "rowId": "string", "reason": "string" } ] } ], "unknowns": [ "string" ] }, "runId": "78c33d18-170c-44d3-a227-b3194f134f73", "datasetId": "6586f21b-ad4d-4d06-a309-712af47184a2", "status": "queued", "attemptId": "ff88f33b-bb8d-4c28-947a-07ff3d628b10", "harnessVersion": "string", "request": { "observations": { "prompt": "string", "sourceUrl": "http://example.com", "plan": { "title": "string", "rowMeaning": "string", "nameLabel": "string", "query": "string", "attributes": [ { "fieldId": "84922011-b03d-4966-bc95-c5b49bc2e342", "label": "string", "description": "string" } ] } }, "unknowns": [ "string" ] }, "sources": { "observations": { "discovery": { "attemptId": "ff88f33b-bb8d-4c28-947a-07ff3d628b10", "query": "string", "depth": "basic", "excludeDomains": [ "string" ], "credits": 0 }, "counts": { "discovered": 0, "checked": 0, "unreadable": 0, "unknown": 0, "unattempted": 0 }, "candidates": [ { "rank": 1, "url": "http://example.com", "title": "string", "score": 0, "outcome": "unattempted" } ] }, "findings": [ { "code": "string", "message": "string" } ], "unknowns": [ "string" ] }, "cells": { "observations": { "rowsFromRun": 0, "rowsInTable": 0, "fields": [ { "fieldId": "84922011-b03d-4966-bc95-c5b49bc2e342", "label": "string", "populated": 0, "notFound": 0, "extractionFailed": 0 } ] }, "findings": [ { "code": "string", "message": "string" } ], "unknowns": [ "string" ] }, "reconciliation": { "observations": { "rejected": { "property1": 0, "property2": 0 }, "quotesDropped": 0, "duplicates": [ { "name": "string", "url": "string", "winnerUrl": "string", "offered": [ "string" ], "merged": [ "string" ] } ] }, "findings": [ { "code": "string", "message": "string" } ], "unknowns": [ "string" ] }, "completion": { "observations": { "status": "queued", "stop": { "rule": "string", "inputs": {} }, "error": "string" }, "findings": [ { "code": "string", "message": "string" } ], "unknowns": [ "string" ] }, "cost": { "observations": { "usage": { "searchCredits": 0, "inputTokens": 0, "outputTokens": 0, "modelUsd": 0 }, "queueMs": 0, "wallMs": 0, "phases": [ { "phase": "planning", "count": 0, "totalMs": 0, "maxMs": 0 } ] }, "unknowns": [ "string" ] } }}