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
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/diagnostics"{ "diagnostics": { "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" ] } }}