> For the complete documentation index, see [llms.txt](https://docs.rootcause.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rootcause.ai/api-and-integrations/rest-api-reference/reports.md).

# Reports

## List reports

> Lists reports in the workspace. Paginated (limit, cursor). Read from platform MongoDB. Reports have title, description, status (e.g. draft), markdown, widgets, evidenceIds.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Reports"}],"servers":[{"url":"https://sandbox.rootcause.ai","description":"Sandbox"},{"url":"https://platform.rootcause.ai","description":"Production"},{"url":"http://localhost:3000","description":"Local development"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one."}},"schemas":{"ReportListEnvelope":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Report"}},"pagination":{"type":"object","properties":{"cursor":{"type":"string","description":"Pass back as ?cursor= to fetch the next page"},"hasMore":{"type":"boolean","description":"Whether a further page exists"},"total":{"type":"number","description":"Total matching rows, when the query can count them"}},"required":["hasMore"]}},"required":["data","pagination"]},"Report":{"type":"object","properties":{"id":{"type":["string","null"]},"workspaceId":{"type":"string"},"organisationId":{"type":"string"},"title":{"type":"string"},"markdown":{"type":"string"},"widgets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"chart"},"explorerConfig":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"dataView":{"anyOf":[{"$ref":"#/components/schemas/DataViewSchema"},{"type":"null"}]},"operations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/OperationSchema"}},{"type":"null"}]},"additionalSources":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SourceSchema"}},{"type":"null"}]},"inlineData":{"anyOf":[{"type":"object","properties":{"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["None","String","Category","Number","Boolean","DateTime","Array","Unknown"]}},"required":["name","type"]},"minItems":1},"rows":{"type":"array","items":{"type":"object","additionalProperties":{"type":["string","number","boolean","null"]}},"default":[]},"downsampled":{"type":"boolean"},"totalRows":{"type":["number","null"]}},"required":["columns"]},{"type":"null"}]},"series":{"anyOf":[{"type":"object","properties":{"labels":{"type":"array","items":{"type":["string","number"]},"default":[]},"datasets":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"meta":{"anyOf":[{"type":"object","properties":{"version":{"type":"number","default":1},"xField":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"]},"default":[]},"series":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"yField":{"type":["string","null"]},"aggregation":{"type":["string","null"]}},"required":["label"]},"default":[]},"categoriesTotal":{"type":["number","null"]},"categoriesShown":{"type":["number","null"]},"otherFolded":{"type":["boolean","null"]},"sortBy":{"type":["string","null"]},"sortType":{"type":["string","null"]},"binCount":{"type":["number","null"]},"linksTotal":{"type":["number","null"]},"linksShown":{"type":["number","null"]},"pointsTotal":{"type":["number","null"]},"pointsShown":{"type":["number","null"]},"rowsScanned":{"type":["number","null"]},"rowsWithoutCategory":{"type":["number","null"]},"rowsExcluded":{"type":["number","null"]},"rowsExcludedBy":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string"},"column":{"type":["string","null"]},"rows":{"type":"number"}},"required":["reason","rows"]}},{"type":"null"}]},"downsampled":{"type":["boolean","null"]},"summary":{"type":"string","default":""}},"additionalProperties":true},{"type":"null"}]}}},{"type":"null"}]},"xSelection":{"type":"string"},"traces":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"bar"},"options":{"anyOf":[{"type":"object","properties":{"stacked":{"type":"boolean","default":false},"aggregation":{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"line"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"anyOf":[{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"},{"type":"null"}]},"tension":{"type":"number","minimum":0,"maximum":1,"default":0.4},"showPoints":{"type":"boolean","default":true}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"scatter"},"options":{"anyOf":[{"type":"object","properties":{"showLine":{"type":"boolean","default":false},"pointRadius":{"type":"number","minimum":1,"maximum":20,"default":3}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"area"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"anyOf":[{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"},{"type":"null"}]},"tension":{"type":"number","minimum":0,"maximum":1,"default":0.4},"fillOpacity":{"type":"number","minimum":0,"maximum":1,"default":0.3}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"histogram"},"options":{"anyOf":[{"type":"object","properties":{"bins":{"type":"number","minimum":5,"maximum":100,"default":20}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"pie"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"default":"sum","type":"string","enum":["average","sum","count","min","max"]}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"doughnut"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"default":"sum","type":"string","enum":["average","sum","count","min","max"]}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"sankey"}},"required":["id","name","ySelection","chartType"]}],"discriminator":{"propertyName":"chartType"}}},"config":{"type":"object","properties":{"responsive":{"type":"boolean","default":true},"chartTitle":{"type":["string","null"]},"dataPoints":{"type":"number","default":-1},"dataDisplayOrder":{"type":"string","enum":["fromStart","fromEnd"],"default":"fromStart"},"sortBy":{"anyOf":[{"type":"string","enum":["none","x","y"]},{"type":"null"}]},"sortType":{"anyOf":[{"type":"string","enum":["ascending","descending","natural"]},{"type":"null"}]},"advancedSettings":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}}}},"required":["id","xSelection","traces","config"]},{"type":"null"}]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"table"},"title":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","additionalProperties":{}}},"rows":{"type":"array","items":{"type":"object","additionalProperties":{}}},"totalRows":{"type":"number"},"csvExport":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"sql_evidence"},"rowCount":{"type":"integer","minimum":0},"queryTruncated":{"type":"boolean"},"queryTotalRowCount":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}},"required":["source","rowCount","queryTruncated"]},{"type":"null"}]},"livePaging":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"anchor_sql"},"sql":{"type":"string"},"projectionMode":{"type":"string","enum":["related","minimal"],"default":"related"}},"required":["source","sql"]},{"type":"null"}]}},"required":["id","evidenceId","type","columns","rows","totalRows"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_preview"},"datasetId":{"type":"string"}},"required":["id","evidenceId","type","datasetId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_view_preview"},"dataViewId":{"type":"string"}},"required":["id","evidenceId","type","dataViewId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"kpi_card"},"title":{"type":"string"},"value":{"type":["string","number"]},"dataBinding":{"anyOf":[{"oneOf":[{"type":"object","properties":{"sourceType":{"type":"string","const":"dataset"},"datasetId":{"type":"string","minLength":1},"valueField":{"type":"string","minLength":1}},"required":["sourceType","datasetId","valueField"]},{"type":"object","properties":{"sourceType":{"type":"string","const":"dataview"},"dataViewId":{"type":"string","minLength":1},"valueField":{"type":"string","minLength":1}},"required":["sourceType","dataViewId","valueField"]}],"discriminator":{"propertyName":"sourceType"}},{"type":"null"}]},"unit":{"type":["string","null"]},"unitId":{"type":["string","null"]},"change":{"type":["number","null"]},"changePeriod":{"type":["string","null"]},"trend":{"anyOf":[{"type":"string","enum":["up","down","neutral"]},{"type":"null"}]}},"required":["id","evidenceId","type","title","value"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_graph"},"digitalTwinVersionId":{"type":"string"}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dataset_search_results"},"searchQuery":{"type":"string"},"datasetIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","datasetIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_view_search_results"},"searchQuery":{"type":"string"},"dataViewIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","dataViewIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_result"},"digitalTwinRunId":{"type":"string"}},"required":["id","evidenceId","type","digitalTwinRunId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_search_results"},"digitalTwinVersionIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","digitalTwinVersionIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_run_search_results"},"searchQuery":{"type":"string"},"runIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","runIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_graph"},"searchQuery":{"type":"string"},"conceptIds":{"type":"array","items":{"type":"string"}},"anchorType":{"type":"string","enum":["dataset","identifier","conceptType"],"default":"dataset"},"showFullGraph":{"type":"boolean","default":false}},"required":["id","evidenceId","type","searchQuery","conceptIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"path_analysis_sankey"},"digitalTwinVersionId":{"type":"string"},"selectedNode":{"type":["string","null"]},"selectedEdge":{"anyOf":[{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},{"type":"null"}]},"depthLimit":{"type":"number","default":2}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"parameter_distribution"},"digitalTwinVersionId":{"type":"string"},"selectedNode":{"type":["string","null"]},"selectedEdge":{"anyOf":[{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},{"type":"null"}]}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_diff"},"version1Id":{"type":"string"},"version2Id":{"type":"string"}},"required":["id","evidenceId","type","version1Id","version2Id"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dose_response"},"causeVariable":{"type":"string"},"sweptMode":{"anyOf":[{"type":"string","enum":["absolute","percentage"]},{"type":"null"}]},"metric":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"causeValue":{"type":"number"},"effect":{"type":"number"},"ciLower":{"type":["number","null"]},"ciUpper":{"type":["number","null"]}},"required":["causeValue","effect"]}},"referenceValue":{"type":["number","null"]},"isLinear":{"type":["boolean","null"]},"inflectionPoints":{"anyOf":[{"type":"array","items":{"type":"number"}},{"type":"null"}]},"digitalTwinRunId":{"type":["string","null"]}},"required":["id","evidenceId","type","causeVariable","metric","points"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"page_context"},"section":{"anyOf":[{"type":"string","enum":["Organisation Home","Workspace Home","Dataset Selection","Dataset Page","Data View Selection","Data View Page","Digital Twin Selection","Digital Twin Page","Report Selection","Report Page","Settings"]},{"type":"null"}]},"summary":{"type":"string"},"entityName":{"type":["string","null"]},"entityType":{"anyOf":[{"type":"string","enum":["dataset","data_view","digital_twin","report"]},{"type":"null"}]},"itemCount":{"type":["number","null"]}},"required":["id","evidenceId","type","summary"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dag_review"},"digitalTwinVersionId":{"type":"string"},"digitalTwinName":{"type":"string"},"nodeCount":{"type":"number"},"edgeCount":{"type":"number"},"overallHealth":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"description":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"suggestedFix":{"type":["string","null"]},"affectedNodes":{"type":"array","items":{"type":"string"},"default":[]},"affectedEdges":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},"default":[]}},"required":["type","description","severity"]},"default":[]},"recommendations":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id","evidenceId","type","digitalTwinVersionId","digitalTwinName","nodeCount","edgeCount","overallHealth"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_context"},"outcomeVariable":{"type":"string"},"relatedConcepts":{"type":"array","items":{"type":"object","properties":{"concept":{"type":"string"},"source":{"type":["string","null"]},"sourceName":{"type":["string","null"]},"role":{"type":["string","null"]},"isIdentifier":{"type":"boolean","default":false}},"required":["concept"]},"default":[]},"datasetSourceCount":{"type":"number","default":0},"recommendation":{"type":["string","null"]},"existingDataViewId":{"type":["string","null"]},"existingDataViewName":{"type":["string","null"]},"existingDigitalTwinId":{"type":["string","null"]},"existingDigitalTwinName":{"type":["string","null"]}},"required":["id","evidenceId","type","outcomeVariable"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"graph_query_result"},"queryType":{"type":"string"},"digitalTwinVersionId":{"type":"string"},"queriedNode":{"type":["string","null"]},"results":{"type":"array","items":{"type":"object","properties":{"node":{"type":"string"},"edgeLabel":{"type":["string","null"]},"strength":{"type":["number","null"]},"depth":{"type":["number","null"]},"type":{"type":["string","null"]}},"required":["node"]},"default":[]},"path":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}},"required":["id","evidenceId","type","queryType","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_data"},"columns":{"type":"array","items":{"type":"string"},"default":[]},"rowCount":{"type":"number","default":0},"sampleRows":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"dataViewId":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_mutation_preview"},"operations":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"successCount":{"type":"number","default":0},"failureCount":{"type":"number","default":0},"affectedConceptIds":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"docs_sources"},"documentReferences":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"path":{"type":"string"},"pageId":{"type":["string","null"]}},"required":["title","path"]}}},"required":["id","evidenceId","type","documentReferences"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"background_runs"},"runs":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"entityId":{"type":["string","null"]},"status":{"type":"string"},"percentage":{"type":["number","null"]},"label":{"type":["string","null"]},"error":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["runId","name","domain","status"]}}},"required":["id","evidenceId","type","runs"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_segments"},"title":{"type":"string"},"silhouetteScore":{"type":["number","null"]},"segments":{"type":"array","items":{"type":"object","properties":{"segment":{"type":"number"},"label":{"type":"string"},"description":{"type":["string","null"]},"environments":{"type":"array","items":{"type":"string"}}},"required":["segment","label","environments"]}},"points":{"type":"array","items":{"type":"object","properties":{"envKey":{"type":"string"},"x":{"type":"number"},"y":{"type":"number"},"segment":{"type":"number"}},"required":["envKey","x","y","segment"]}}},"required":["id","evidenceId","type","title","segments","points"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_comparison"},"title":{"type":"string"},"sliceLabel":{"type":"string"},"baselineLabel":{"type":"string"},"sliceEnvCount":{"type":"number"},"baselineEnvCount":{"type":"number"},"edges":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"sliceAgreement":{"type":"number"},"baselineAgreement":{"type":"number"},"sliceStrength":{"type":["number","null"]},"baselineStrength":{"type":["number","null"]},"verdict":{"type":"string","enum":["slice-only","missing-from-slice","differs","consistent"]}},"required":["source","target","sliceAgreement","baselineAgreement","verdict"]}}},"required":["id","evidenceId","type","title","sliceLabel","baselineLabel","sliceEnvCount","baselineEnvCount","edges"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_coverage"},"title":{"type":"string"},"environments":{"type":"array","items":{"type":"object","properties":{"envKey":{"type":"string"},"trainingRows":{"type":["number","null"]},"variablesTrained":{"type":["number","null"]},"variablesTotal":{"type":["number","null"]},"missing":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"reason":{"type":["string","null"]}},"required":["name"]}},"evaluation":{"type":["string","null"]}},"required":["envKey","missing"]}}},"required":["id","evidenceId","type","title","environments"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"clarification"},"toolCallId":{"type":"string"},"mode":{"type":"string","enum":["multiple_choice","form"]},"question":{"type":"string"},"why":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"preview":{"type":["string","null"]}},"required":["label","value"]},"default":[]},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"type":{"type":"string","enum":["number","string","select","multiselect","boolean","source","dataset","digitalTwin","ontologyConcept"],"default":"string"},"default":{"anyOf":[{},{"type":"null"}]},"options":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"value":{"type":"string"},"label":{"type":["string","null"]}},"required":["value"]}]}},{"type":"null"}]},"min":{"type":["number","null"]},"max":{"type":["number","null"]},"step":{"type":["number","null"]},"pattern":{"type":["string","null"]},"control":{"type":["string","null"]},"placeholder":{"type":["string","null"]},"help":{"type":["string","null"]},"required":{"type":["boolean","null"]},"secret":{"type":["boolean","null"]},"urlParam":{"type":["string","null"]}},"required":["id"]},"default":[]},"selectedValues":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"selectedFieldValues":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["id","evidenceId","type","toolCallId","mode","question"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"action_confirmation"},"toolCallId":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"severity":{"type":"string","enum":["mutates_truth","long_running","irreversible"]},"actionLabel":{"type":"string"},"estimatedDuration":{"type":["string","null"]},"changes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"before":{"type":["string","null"]},"after":{"type":["string","null"]}},"required":["label"]}},{"type":"null"}]},"details":{"type":["string","null"]},"editableKind":{"anyOf":[{"type":"string","enum":["extraction_schema"]},{"type":"null"}]},"editableInputs":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"toolName":{"type":["string","null"]},"toolInputs":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}},"required":["id","evidenceId","type","toolCallId","title","summary","severity","actionLabel"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"navigation"},"commandId":{"type":"string"},"label":{"type":"string"},"subtitle":{"type":["string","null"]},"kind":{"type":"string","enum":["navigate","create","action"],"default":"navigate"},"entity":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["dataset","dataview","concept","digitalTwin","report","digitalTwinRun"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"]},{"type":"null"}]}},"required":["id","evidenceId","type","commandId","label"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"foundational_ontology_install"},"ontologyId":{"type":"string"},"version":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"trustTier":{"type":"string"},"anchorsSummary":{"type":["string","null"]},"conceptCount":{"type":"number"},"sourceCount":{"type":"number"},"suggestedScopeNote":{"type":["string","null"]}},"required":["id","evidenceId","type","ontologyId","version","name","trustTier","conceptCount","sourceCount"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"stat_grid"},"title":{"type":["string","null"]},"stats":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"value":{"type":["string","number"]},"unit":{"type":["string","null"]},"unitId":{"type":["string","null"]},"decimals":{"type":["number","null"]},"change":{"type":["number","null"]},"changePeriod":{"type":["string","null"]},"trend":{"anyOf":[{"type":"string","enum":["up","down","neutral"]},{"type":"null"}]}},"required":["title","value"]}},"gridCols":{"anyOf":[{"type":"number","enum":[2,3,4]},{"type":"null"}]}},"required":["id","evidenceId","type","stats"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"markdown"},"content":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"heading"},"text":{"type":["string","null"]},"eyebrow":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"divider"},"style":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"image"},"src":{"type":["string","null"]},"alt":{"type":["string","null"]},"caption":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"iframe"},"url":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"application"},"applicationId":{"type":"string"},"runId":{"type":["string","null"]},"name":{"type":["string","null"]},"status":{"type":["string","null"]},"moduleCount":{"type":["number","null"]},"publicUrl":{"type":["string","null"]}},"required":["id","evidenceId","type","applicationId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"report"},"reportId":{"type":"string"},"title":{"type":["string","null"]},"status":{"type":["string","null"]},"rev":{"type":["number","null"]}},"required":["id","evidenceId","type","reportId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"lineage"},"lineageId":{"type":"string"},"tool":{"type":"string","default":""},"hops":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","default":""}},"required":["kind","id"]},"status":{"type":"string","enum":["resolved","denied","deleted"]},"parents":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","default":""}},"required":["kind","id"]},"default":[]},"pin":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"versionId":{"type":["string","null"]},"ordinal":{"type":["number","null"]},"deltaVersion":{"type":["number","null"]},"label":{"type":["string","null"]}},"required":["kind","id"]},{"type":"null"}]},"detail":{"type":"object","additionalProperties":{},"default":{}}},"required":["ref","status"]},"default":[]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":["number","null"]},"valueType":{"type":["string","null"]},"unit":{"type":["string","null"]},"display":{"type":["string","null"]}}},{"type":"null"}]},"request":{"anyOf":[{"type":"object","properties":{"sql":{"type":["string","null"]},"query":{"type":["string","null"]}}},{"type":"null"}]}},"required":["id","evidenceId","type","lineageId"]}],"discriminator":{"propertyName":"type"}}},"evidenceIds":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"status":{"$ref":"#/components/schemas/ReportStatusSchema"},"rev":{"type":"integer"},"error":{"type":["string","null"]},"prompt":{"type":["string","null"]},"publish":{"anyOf":[{"$ref":"#/components/schemas/reportPublishSchema"},{"type":"null"}]}},"required":["workspaceId","organisationId","title","markdown","widgets","evidenceIds","createdAt","updatedAt"]},"DataViewSchema":{"type":"object","properties":{"_id":{"type":"string"},"organisationId":{"type":"string"},"workspaceId":{"type":"string"},"ownerId":{"type":"string"},"name":{"type":"string"},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"rowCount":{"type":["number","null"]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceSchema"}},"operations":{"type":"array","items":{"$ref":"#/components/schemas/OperationSchema"}},"anchorConceptId":{"type":["string","null"]},"createdBy":{"anyOf":[{"$ref":"#/components/schemas/DataViewCreatedByEnum"},{"type":"null"}]},"sourceQuery":{"anyOf":[{"$ref":"#/components/schemas/DataViewSourceQuerySchema"},{"type":"null"}]},"sourceQueryDetached":{"type":["boolean","null"]},"chartWidgets":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"layout":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},"widget":{"type":"object","additionalProperties":{}}},"required":["id","layout","widget"]}},{"type":"null"}]},"conceptOverrides":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ViewConceptOverrideEntrySchema"}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["ok","broken"]},{"type":"null"}]},"brokenReasons":{"anyOf":[{"type":"array","items":{"type":"string","enum":["source_removed","ontology_reset"]}},{"type":"null"}]},"brokenDependencies":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/BrokenDataViewDependencySchema"}},{"type":"null"}]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["_id","organisationId","workspaceId","ownerId","name","sources","operations"]},"SourceSchema":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"DATASET"},"name":{"type":["string","null"]},"conceptIds":{"type":"array","items":{"type":"string"}},"conceptVersions":{"anyOf":[{"type":"object","additionalProperties":{"type":"integer","minimum":0}},{"type":"null"}]},"version":{"anyOf":[{"$ref":"#/components/schemas/SourcePinSchema"},{"type":"null"}]}},"required":["id","type","conceptIds"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"DATA_VIEW"},"name":{"type":["string","null"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"CONCEPT"},"name":{"type":["string","null"]},"prioritiseCalculation":{"type":"boolean","default":true},"showCalculationColumns":{"type":"boolean","default":false}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"GEO_SIDECAR"},"name":{"type":["string","null"]},"conceptId":{"type":"string"},"sidecarKey":{"type":"string"}},"required":["id","type","conceptId","sidecarKey"]}],"discriminator":{"propertyName":"type"}},"SourcePinSchema":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"latest"}},"required":["kind"]},{"type":"object","properties":{"kind":{"type":"string","const":"pinned"},"versionId":{"type":"string"}},"required":["kind","versionId"]}],"discriminator":{"propertyName":"kind"}},"OperationSchema":{"type":"object","properties":{"id":{"type":"string"},"sourceId":{"type":"string"},"config":{"$ref":"#/components/schemas/OperationConfigSchema"}},"required":["id","sourceId","config"]},"OperationConfigSchema":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"FILTER"},"filterGroup":{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]}},"required":["type","filterGroup"]},{"type":"object","properties":{"type":{"type":"string","const":"AGGREGATE"},"groupByColumns":{"type":"array","items":{"type":"string"}},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}}},"required":["type","groupByColumns","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"JOIN"},"joinType":{"$ref":"#/components/schemas/JoinTypeEnum"},"columnPairs":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/JoinColumnPairSchema"}},{"type":"null"}]},"leftField":{"type":["string","null"]},"rightField":{"type":["string","null"]},"conflictResolution":{"$ref":"#/components/schemas/JoinConflictResolutionEnum"},"leftPrefix":{"type":["string","null"]},"rightPrefix":{"type":["string","null"]}},"required":["type","joinType","conflictResolution"]},{"type":"object","properties":{"type":{"type":"string","const":"CONCATENATE"},"topSource":{"type":["string","null"]},"bottomSource":{"type":["string","null"]},"sources":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"columnMapping":{"type":"object","additionalProperties":{"type":"string"}},"unmatchedRule":{"$ref":"#/components/schemas/UnmatchedRuleEnum"},"discriminatorColumn":{"type":["string","null"]},"discriminatorValues":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["type","columnMapping","unmatchedRule"]},{"type":"object","properties":{"type":{"type":"string","const":"SORT"},"sortColumns":{"type":"array","items":{"$ref":"#/components/schemas/SortColumnSchema"}}},"required":["type","sortColumns"]},{"type":"object","properties":{"type":{"type":"string","const":"SQL_QUERY"},"query":{"type":"string"},"columnSourceAliases":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["type","query"]},{"type":"object","properties":{"type":{"type":"string","const":"SPLIT_COLUMN"},"columnToSplit":{"type":"string"},"splitType":{"$ref":"#/components/schemas/SplitTypeEnum"},"delimiter":{"type":["string","null"]},"columns":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/NewColumnDefinitionSchema"}},{"type":"null"}]}},"required":["type","columnToSplit","splitType"]},{"type":"object","properties":{"type":{"type":"string","const":"DROP_COLUMNS"},"columns":{"type":"array","items":{"type":"string"}}},"required":["type","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"REMOVE_DUPLICATES"},"column":{"type":["string","null"]},"keep":{"$ref":"#/components/schemas/KeepEnum","default":"first"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"IMPUTE_NULLS"},"method":{"$ref":"#/components/schemas/ImputeMethodEnum","default":"constant"},"column":{"type":["string","null"]},"fillValue":{"anyOf":[{"type":["string","number","boolean"]},{"type":"null"}]},"imputations":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"method":{"$ref":"#/components/schemas/ImputeMethodEnum","default":"constant"},"fillValue":{"anyOf":[{"type":["string","number","boolean"]},{"type":"null"}]}},"required":["column"]}},{"type":"null"}]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"DROP_NULLS"},"axis":{"type":"string","enum":["rows","empty_columns"],"default":"rows"},"column":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"string"},"default":[]},"nullThresholdPercent":{"type":"number","default":100}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"REPLACE_VALUES"},"column":{"type":"string"},"mapping":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["type","column","mapping"]},{"type":"object","properties":{"type":{"type":"string","const":"REPLACE_TYPE"},"changes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"toType":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"toSubType":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"dateFormat":{"type":["string","null"]}},"required":["column","toType"]}},{"type":"null"}]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"INTERPOLATE_TIME"},"column":{"type":"string"},"frequency":{"type":"string"},"method":{"$ref":"#/components/schemas/InterpolateTimeMethodEnum"}},"required":["type","column","frequency","method"]},{"type":"object","properties":{"type":{"type":"string","const":"CLIP_OUTLIERS"},"column":{"type":"string"},"lowerQuantile":{"type":"number","default":0.05},"upperQuantile":{"type":"number","default":0.95}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"NORMALIZE_NUMERIC"},"column":{"type":"string"},"method":{"$ref":"#/components/schemas/NormalizeNumericMethodEnum","default":"z_score"}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"MAP_CATEGORIES"},"column":{"type":"string"},"mapping":{"type":"object","additionalProperties":{"type":"string"}},"defaultValue":{"type":["string","null"]}},"required":["type","column","mapping"]},{"type":"object","properties":{"type":{"type":"string","const":"TIME_SERIES_AGGREGATE"},"timeColumn":{"type":"string"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}},"dateFormat":{"anyOf":[{"$ref":"#/components/schemas/DatetimeFormatSchema"},{"type":"null"}]}},"required":["type","timeColumn","granularity","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"TIME_SERIES_JOIN"},"joinType":{"$ref":"#/components/schemas/JoinTypeEnum"},"leftTimeColumn":{"type":"string"},"rightTimeColumn":{"type":"string"},"rightSource":{"type":"string"},"strategy":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"granularity"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]}},"required":["type","granularity"]},{"type":"object","properties":{"type":{"type":"string","const":"asOf"},"direction":{"$ref":"#/components/schemas/AsOfDirectionEnum"},"tolerance":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"$ref":"#/components/schemas/ToleranceUnitEnum"}},"required":["value","unit"]},{"type":"null"}]}},"required":["type","direction"]},{"type":"object","properties":{"type":{"type":"string","const":"interval"},"leftEndColumn":{"type":"string"}},"required":["type","leftEndColumn"]}],"discriminator":{"propertyName":"type"}},"exactMatchKeys":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"leftField":{"type":"string"},"rightField":{"type":"string"}},"required":["leftField","rightField"]}},{"type":"null"}]},"multiMatch":{"$ref":"#/components/schemas/MultiMatchStrategyEnum"},"multiMatchAggregations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}},{"type":"null"}]}},"required":["type","joinType","leftTimeColumn","rightTimeColumn","rightSource","strategy","multiMatch"]},{"type":"object","properties":{"type":{"type":"string","const":"TRANSPOSE"},"timeColumn":{"type":"string"},"envColumns":{"type":"array","items":{"type":"string"}},"valueColumns":{"type":"array","items":{"type":"string"}},"columnTemplate":{"type":"string"},"joinStrategy":{"anyOf":[{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"granularity"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]}},"required":["type","granularity"]},{"type":"object","properties":{"type":{"type":"string","const":"asOf"},"direction":{"$ref":"#/components/schemas/AsOfDirectionEnum"},"tolerance":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"$ref":"#/components/schemas/ToleranceUnitEnum"}},"required":["value","unit"]},{"type":"null"}]}},"required":["type","direction"]}],"discriminator":{"propertyName":"type"}},{"type":"null"}]}},"required":["type","timeColumn","envColumns","valueColumns","columnTemplate"]},{"type":"object","properties":{"type":{"type":"string","const":"FREQUENCY_ANALYSIS"},"timeColumn":{"type":"string"},"valueColumns":{"type":"array","items":{"type":"string"}},"method":{"$ref":"#/components/schemas/FrequencyMethodEnum"},"windowFunction":{"$ref":"#/components/schemas/FrequencyWindowFunctionEnum","default":"hann"},"windowSize":{"type":["number","null"]},"overlap":{"type":"number","default":0.5},"samplingRateHz":{"type":["number","null"]},"outputFormat":{"$ref":"#/components/schemas/FrequencyOutputFormatEnum"},"frequencyRange":{"anyOf":[{"type":"object","properties":{"minHz":{"type":["number","null"]},"maxHz":{"type":["number","null"]}}},{"type":"null"}]},"frequencyUnit":{"$ref":"#/components/schemas/FrequencyUnitEnum","default":"hz"}},"required":["type","timeColumn","valueColumns","method","outputFormat"]},{"type":"object","properties":{"type":{"type":"string","const":"CYCLIC_AGGREGATE"},"timeColumn":{"type":"string"},"cycleComponent":{"$ref":"#/components/schemas/CyclicComponentEnum"},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}}},"required":["type","timeColumn","cycleComponent","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"DIFF"},"timeColumn":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"partitionColumns":{"type":"array","items":{"type":"string"},"default":[]},"outputSuffix":{"type":"string","default":"_diff"},"replaceColumns":{"type":"boolean","default":false}},"required":["type","timeColumn","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"DATE_DIFF"},"startColumn":{"type":"string"},"endColumn":{"type":"string"},"unit":{"$ref":"#/components/schemas/DateDiffUnitEnum","default":"days"},"sign":{"$ref":"#/components/schemas/DateDiffSignEnum","default":"signed"},"outputColumn":{"type":["string","null"]}},"required":["type","startColumn","endColumn"]},{"type":"object","properties":{"type":{"type":"string","const":"CUMULATIVE"},"timeColumn":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"partitionColumns":{"type":"array","items":{"type":"string"},"default":[]},"outputSuffix":{"type":"string","default":"_cumsum"},"replaceColumns":{"type":"boolean","default":false}},"required":["type","timeColumn","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_DECOMPOSE"},"column":{"type":"string"},"mode":{"$ref":"#/components/schemas/ArrayDecomposeModeEnum","default":"position"},"maxColumns":{"type":"integer","exclusiveMinimum":0,"default":500},"outputPrefix":{"type":"string","default":"_"}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_CONSOLIDATE"},"groups":{"type":"array","items":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"string"},"minItems":1},"outputColumn":{"type":"string"},"dropSource":{"type":"boolean","default":true},"includeNulls":{"type":"boolean","default":false}},"required":["columns","outputColumn"]},"minItems":1}},"required":["type","groups"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_EXPLODE"},"column":{"type":"string"},"outputColumn":{"type":["string","null"]},"preserveIndex":{"type":"boolean","default":false}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_AGGREGATE"},"column":{"type":"string"},"aggregation":{"$ref":"#/components/schemas/ArrayAggregationKindEnum"},"outputColumn":{"type":["string","null"]}},"required":["type","column","aggregation"]},{"type":"object","properties":{"type":{"type":"string","const":"JSON_FLATTEN"},"column":{"type":"string"},"maxColumns":{"type":"integer","exclusiveMinimum":0,"default":500},"separator":{"type":"string","default":"."},"dropSource":{"type":"boolean","default":true}},"required":["type","column"]}],"discriminator":{"propertyName":"type"}},"FilterSchema":{"type":"object","properties":{"column":{"type":"string"},"comparisonOperator":{"$ref":"#/components/schemas/ComparisonOperatorEnum"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":["string","number","boolean"]}}]},"correctType":{"type":"boolean"}},"required":["column","comparisonOperator","value","correctType"]},"ComparisonOperatorEnum":{"type":"string","enum":["Equal to","Not Equal to","Contains","Does not contain","Starts with","Ends with","Is Empty","Is not Empty","Less than","Greater than","Less than or equal to","Greater than or equal to","Before","After","Array contains","Array contains any","Array contains all","Array does not contain","Array does not contain any","Array does not contain all","Array size equal to","Array size greater than","Array size less than"]},"FilterGroupSchema":{"type":"object","properties":{"booleanOperator":{"$ref":"#/components/schemas/LogicalOperatorEnum"},"filters":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]}}},"required":["booleanOperator","filters"]},"LogicalOperatorEnum":{"type":"string","enum":["AND","OR"]},"AggregationFunctionSchema":{"type":"object","properties":{"column":{"type":"string"},"function":{"$ref":"#/components/schemas/AggregateFunctionEnum"},"alias":{"type":["string","null"]},"filter":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]},{"type":"null"}]}},"required":["column","function"]},"AggregateFunctionEnum":{"type":"string","enum":["sum","avg","min","max","count","countDistinct","first","last","categoryShare"]},"JoinTypeEnum":{"type":"string","enum":["inner","left","right","full"]},"JoinColumnPairSchema":{"type":"object","properties":{"leftField":{"type":"string"},"rightField":{"type":"string"}},"required":["leftField","rightField"]},"JoinConflictResolutionEnum":{"type":"string","enum":["keep_left","keep_right","prefix"]},"UnmatchedRuleEnum":{"type":"string","enum":["error","drop","append"]},"SortColumnSchema":{"type":"object","properties":{"column":{"type":"string"},"direction":{"$ref":"#/components/schemas/SortDirectionEnum"}},"required":["column","direction"]},"SortDirectionEnum":{"type":"string","enum":["asc","desc"]},"SplitTypeEnum":{"type":"string","enum":["delimiter","pattern"]},"NewColumnDefinitionSchema":{"type":"object","properties":{"name":{"type":"string"},"pattern":{"type":["string","null"]}},"required":["name"]},"KeepEnum":{"type":"string","enum":["first","last"]},"ImputeMethodEnum":{"type":"string","enum":["mean","median","mode","constant"]},"SchemaMainTypeEnum":{"type":"string","enum":["None","String","Category","Number","Boolean","DateTime","Array","Unknown"]},"SchemaSubTypeEnum":{"type":"string","enum":["Integer","Float","UnsignedInteger","UnsignedFloat","String","Number","Category","Boolean","DateTime"]},"InterpolateTimeMethodEnum":{"type":"string","enum":["linear","time","index"]},"NormalizeNumericMethodEnum":{"type":"string","enum":["min_max","z_score"]},"DatetimeFormatSchema":{"type":"string","minLength":1},"AsOfDirectionEnum":{"type":"string","enum":["backward","forward","nearest"]},"ToleranceUnitEnum":{"type":"string","enum":["us","ms","s","m","h","d"]},"MultiMatchStrategyEnum":{"type":"string","enum":["first","last","aggregate"]},"FrequencyMethodEnum":{"type":"string","enum":["fft","welch"]},"FrequencyWindowFunctionEnum":{"type":"string","enum":["hann","hamming","blackman","rectangular"]},"FrequencyOutputFormatEnum":{"type":"string","enum":["spectrogram","time_frequency_long"]},"FrequencyUnitEnum":{"type":"string","enum":["hz","per_minute","per_hour","per_day","per_week","per_month","per_year"]},"CyclicComponentEnum":{"type":"string","enum":["second_in_minute","minute_in_hour","hour_of_day","day_of_week","day_of_month","week_of_year","month_of_year","quarter_of_year"]},"DateDiffUnitEnum":{"type":"string","enum":["seconds","minutes","hours","days","weeks"]},"DateDiffSignEnum":{"type":"string","enum":["signed","absolute"]},"ArrayDecomposeModeEnum":{"type":"string","enum":["position","one_hot"]},"ArrayAggregationKindEnum":{"type":"string","enum":["mean","sum","min","max","median","count"]},"DataViewCreatedByEnum":{"type":"string","enum":["manual","ontology_query","ai","recommended"]},"DataViewSourceQuerySchema":{"type":"object","properties":{"queryRequest":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"reconciliationColumnSides":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ReconciliationColumnSideEnum"}},{"type":"null"}]},"reconciliationColumnGroups":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ReconciliationColumnGroupSchema"}},{"type":"null"}]},"reconciliationSecondaries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ReconciliationSecondaryMetaSchema"}},{"type":"null"}]},"reconciliationAlignKeyLabels":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"additionalProperties":true},"ReconciliationColumnSideEnum":{"type":"string","enum":["primary","secondary","system","context"]},"ReconciliationColumnGroupSchema":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"fieldIds":{"type":"array","items":{"type":"string"}}},"required":["key","label","fieldIds"]},"ReconciliationSecondaryMetaSchema":{"type":"object","properties":{"secondaryKey":{"type":"string"},"secondaryName":{"type":"string"},"presenceCol":{"type":["string","null"]},"mismatchCol":{"type":["string","null"]},"statusCol":{"type":["string","null"]}},"required":["secondaryKey","secondaryName"]},"ViewConceptOverrideEntrySchema":{"type":"object","properties":{"override":{"type":"object","additionalProperties":{}},"displayName":{"type":["string","null"]},"description":{"type":["string","null"]},"lineageHash":{"type":["string","null"]},"lastEditedBy":{"type":["string","null"]},"lastEditedAt":{"type":["string","null"]}},"required":["override"]},"BrokenDataViewDependencySchema":{"type":"object","properties":{"type":{"type":"string","enum":["DATASET","DATA_VIEW"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"]},"ReportStatusSchema":{"type":"string","enum":["draft","ready","error"]},"reportPublishSchema":{"type":"object","properties":{"slug":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"consumerAccess":{"anyOf":[{"type":"string","enum":["private","workspace","organisation","public"]},{"type":"null"}]},"resolvedInputs":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"datasetId":{"type":"string"},"versionId":{"type":["string","null"]},"deltaVersion":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["datasetId"]}},{"type":"null"}]},"widgetSnapshot":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":{}}},{"type":"null"}]},"snapshotAt":{"type":["string","null"]},"snapshotStats":{"anyOf":[{"type":"object","properties":{"requested":{"type":"number"},"resolved":{"type":"number"},"omitted":{"type":"number"},"timedOut":{"type":"boolean"},"bytes":{"type":"number"}},"required":["requested","resolved","omitted","timedOut","bytes"]},{"type":"null"}]}}}},"responses":{"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"429":{"description":"Too Many Requests; the response carries Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}}}},"paths":{"/api/v1/workspaces/{wsId}/reports":{"get":{"operationId":"get-api-v1-workspaces-{wsId}-reports","summary":"List reports","description":"Lists reports in the workspace. Paginated (limit, cursor). Read from platform MongoDB. Reports have title, description, status (e.g. draft), markdown, widgets, evidenceIds.","tags":["Reports"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{"description":"Page size (1-1000, default 50).","type":"number","minimum":1,"maximum":1000},"description":"Page size (1-1000, default 50)."},{"in":"query","name":"cursor","required":false,"schema":{"type":"string","description":"Opaque cursor from a previous response's `pagination.cursor`."},"description":"Opaque cursor from a previous response's `pagination.cursor`."},{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportListEnvelope"}}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Create report

> Creates a new report. Body: title, optional description. Report is created in draft status with empty markdown, widgets, and evidenceIds. Stored in platform MongoDB; content is written via PATCH or by the agent's report tools.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Reports"}],"servers":[{"url":"https://sandbox.rootcause.ai","description":"Sandbox"},{"url":"https://platform.rootcause.ai","description":"Production"},{"url":"http://localhost:3000","description":"Local development"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one."}},"schemas":{"CreateReportInput":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":["string","null"]}},"required":["title"]},"ReportEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Report"}},"required":["data"]},"Report":{"type":"object","properties":{"id":{"type":["string","null"]},"workspaceId":{"type":"string"},"organisationId":{"type":"string"},"title":{"type":"string"},"markdown":{"type":"string"},"widgets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"chart"},"explorerConfig":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"dataView":{"anyOf":[{"$ref":"#/components/schemas/DataViewSchema"},{"type":"null"}]},"operations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/OperationSchema"}},{"type":"null"}]},"additionalSources":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SourceSchema"}},{"type":"null"}]},"inlineData":{"anyOf":[{"type":"object","properties":{"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["None","String","Category","Number","Boolean","DateTime","Array","Unknown"]}},"required":["name","type"]},"minItems":1},"rows":{"type":"array","items":{"type":"object","additionalProperties":{"type":["string","number","boolean","null"]}},"default":[]},"downsampled":{"type":"boolean"},"totalRows":{"type":["number","null"]}},"required":["columns"]},{"type":"null"}]},"series":{"anyOf":[{"type":"object","properties":{"labels":{"type":"array","items":{"type":["string","number"]},"default":[]},"datasets":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"meta":{"anyOf":[{"type":"object","properties":{"version":{"type":"number","default":1},"xField":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"]},"default":[]},"series":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"yField":{"type":["string","null"]},"aggregation":{"type":["string","null"]}},"required":["label"]},"default":[]},"categoriesTotal":{"type":["number","null"]},"categoriesShown":{"type":["number","null"]},"otherFolded":{"type":["boolean","null"]},"sortBy":{"type":["string","null"]},"sortType":{"type":["string","null"]},"binCount":{"type":["number","null"]},"linksTotal":{"type":["number","null"]},"linksShown":{"type":["number","null"]},"pointsTotal":{"type":["number","null"]},"pointsShown":{"type":["number","null"]},"rowsScanned":{"type":["number","null"]},"rowsWithoutCategory":{"type":["number","null"]},"rowsExcluded":{"type":["number","null"]},"rowsExcludedBy":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string"},"column":{"type":["string","null"]},"rows":{"type":"number"}},"required":["reason","rows"]}},{"type":"null"}]},"downsampled":{"type":["boolean","null"]},"summary":{"type":"string","default":""}},"additionalProperties":true},{"type":"null"}]}}},{"type":"null"}]},"xSelection":{"type":"string"},"traces":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"bar"},"options":{"anyOf":[{"type":"object","properties":{"stacked":{"type":"boolean","default":false},"aggregation":{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"line"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"anyOf":[{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"},{"type":"null"}]},"tension":{"type":"number","minimum":0,"maximum":1,"default":0.4},"showPoints":{"type":"boolean","default":true}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"scatter"},"options":{"anyOf":[{"type":"object","properties":{"showLine":{"type":"boolean","default":false},"pointRadius":{"type":"number","minimum":1,"maximum":20,"default":3}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"area"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"anyOf":[{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"},{"type":"null"}]},"tension":{"type":"number","minimum":0,"maximum":1,"default":0.4},"fillOpacity":{"type":"number","minimum":0,"maximum":1,"default":0.3}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"histogram"},"options":{"anyOf":[{"type":"object","properties":{"bins":{"type":"number","minimum":5,"maximum":100,"default":20}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"pie"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"default":"sum","type":"string","enum":["average","sum","count","min","max"]}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"doughnut"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"default":"sum","type":"string","enum":["average","sum","count","min","max"]}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"sankey"}},"required":["id","name","ySelection","chartType"]}],"discriminator":{"propertyName":"chartType"}}},"config":{"type":"object","properties":{"responsive":{"type":"boolean","default":true},"chartTitle":{"type":["string","null"]},"dataPoints":{"type":"number","default":-1},"dataDisplayOrder":{"type":"string","enum":["fromStart","fromEnd"],"default":"fromStart"},"sortBy":{"anyOf":[{"type":"string","enum":["none","x","y"]},{"type":"null"}]},"sortType":{"anyOf":[{"type":"string","enum":["ascending","descending","natural"]},{"type":"null"}]},"advancedSettings":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}}}},"required":["id","xSelection","traces","config"]},{"type":"null"}]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"table"},"title":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","additionalProperties":{}}},"rows":{"type":"array","items":{"type":"object","additionalProperties":{}}},"totalRows":{"type":"number"},"csvExport":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"sql_evidence"},"rowCount":{"type":"integer","minimum":0},"queryTruncated":{"type":"boolean"},"queryTotalRowCount":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}},"required":["source","rowCount","queryTruncated"]},{"type":"null"}]},"livePaging":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"anchor_sql"},"sql":{"type":"string"},"projectionMode":{"type":"string","enum":["related","minimal"],"default":"related"}},"required":["source","sql"]},{"type":"null"}]}},"required":["id","evidenceId","type","columns","rows","totalRows"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_preview"},"datasetId":{"type":"string"}},"required":["id","evidenceId","type","datasetId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_view_preview"},"dataViewId":{"type":"string"}},"required":["id","evidenceId","type","dataViewId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"kpi_card"},"title":{"type":"string"},"value":{"type":["string","number"]},"dataBinding":{"anyOf":[{"oneOf":[{"type":"object","properties":{"sourceType":{"type":"string","const":"dataset"},"datasetId":{"type":"string","minLength":1},"valueField":{"type":"string","minLength":1}},"required":["sourceType","datasetId","valueField"]},{"type":"object","properties":{"sourceType":{"type":"string","const":"dataview"},"dataViewId":{"type":"string","minLength":1},"valueField":{"type":"string","minLength":1}},"required":["sourceType","dataViewId","valueField"]}],"discriminator":{"propertyName":"sourceType"}},{"type":"null"}]},"unit":{"type":["string","null"]},"unitId":{"type":["string","null"]},"change":{"type":["number","null"]},"changePeriod":{"type":["string","null"]},"trend":{"anyOf":[{"type":"string","enum":["up","down","neutral"]},{"type":"null"}]}},"required":["id","evidenceId","type","title","value"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_graph"},"digitalTwinVersionId":{"type":"string"}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dataset_search_results"},"searchQuery":{"type":"string"},"datasetIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","datasetIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_view_search_results"},"searchQuery":{"type":"string"},"dataViewIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","dataViewIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_result"},"digitalTwinRunId":{"type":"string"}},"required":["id","evidenceId","type","digitalTwinRunId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_search_results"},"digitalTwinVersionIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","digitalTwinVersionIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_run_search_results"},"searchQuery":{"type":"string"},"runIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","runIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_graph"},"searchQuery":{"type":"string"},"conceptIds":{"type":"array","items":{"type":"string"}},"anchorType":{"type":"string","enum":["dataset","identifier","conceptType"],"default":"dataset"},"showFullGraph":{"type":"boolean","default":false}},"required":["id","evidenceId","type","searchQuery","conceptIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"path_analysis_sankey"},"digitalTwinVersionId":{"type":"string"},"selectedNode":{"type":["string","null"]},"selectedEdge":{"anyOf":[{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},{"type":"null"}]},"depthLimit":{"type":"number","default":2}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"parameter_distribution"},"digitalTwinVersionId":{"type":"string"},"selectedNode":{"type":["string","null"]},"selectedEdge":{"anyOf":[{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},{"type":"null"}]}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_diff"},"version1Id":{"type":"string"},"version2Id":{"type":"string"}},"required":["id","evidenceId","type","version1Id","version2Id"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dose_response"},"causeVariable":{"type":"string"},"sweptMode":{"anyOf":[{"type":"string","enum":["absolute","percentage"]},{"type":"null"}]},"metric":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"causeValue":{"type":"number"},"effect":{"type":"number"},"ciLower":{"type":["number","null"]},"ciUpper":{"type":["number","null"]}},"required":["causeValue","effect"]}},"referenceValue":{"type":["number","null"]},"isLinear":{"type":["boolean","null"]},"inflectionPoints":{"anyOf":[{"type":"array","items":{"type":"number"}},{"type":"null"}]},"digitalTwinRunId":{"type":["string","null"]}},"required":["id","evidenceId","type","causeVariable","metric","points"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"page_context"},"section":{"anyOf":[{"type":"string","enum":["Organisation Home","Workspace Home","Dataset Selection","Dataset Page","Data View Selection","Data View Page","Digital Twin Selection","Digital Twin Page","Report Selection","Report Page","Settings"]},{"type":"null"}]},"summary":{"type":"string"},"entityName":{"type":["string","null"]},"entityType":{"anyOf":[{"type":"string","enum":["dataset","data_view","digital_twin","report"]},{"type":"null"}]},"itemCount":{"type":["number","null"]}},"required":["id","evidenceId","type","summary"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dag_review"},"digitalTwinVersionId":{"type":"string"},"digitalTwinName":{"type":"string"},"nodeCount":{"type":"number"},"edgeCount":{"type":"number"},"overallHealth":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"description":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"suggestedFix":{"type":["string","null"]},"affectedNodes":{"type":"array","items":{"type":"string"},"default":[]},"affectedEdges":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},"default":[]}},"required":["type","description","severity"]},"default":[]},"recommendations":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id","evidenceId","type","digitalTwinVersionId","digitalTwinName","nodeCount","edgeCount","overallHealth"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_context"},"outcomeVariable":{"type":"string"},"relatedConcepts":{"type":"array","items":{"type":"object","properties":{"concept":{"type":"string"},"source":{"type":["string","null"]},"sourceName":{"type":["string","null"]},"role":{"type":["string","null"]},"isIdentifier":{"type":"boolean","default":false}},"required":["concept"]},"default":[]},"datasetSourceCount":{"type":"number","default":0},"recommendation":{"type":["string","null"]},"existingDataViewId":{"type":["string","null"]},"existingDataViewName":{"type":["string","null"]},"existingDigitalTwinId":{"type":["string","null"]},"existingDigitalTwinName":{"type":["string","null"]}},"required":["id","evidenceId","type","outcomeVariable"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"graph_query_result"},"queryType":{"type":"string"},"digitalTwinVersionId":{"type":"string"},"queriedNode":{"type":["string","null"]},"results":{"type":"array","items":{"type":"object","properties":{"node":{"type":"string"},"edgeLabel":{"type":["string","null"]},"strength":{"type":["number","null"]},"depth":{"type":["number","null"]},"type":{"type":["string","null"]}},"required":["node"]},"default":[]},"path":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}},"required":["id","evidenceId","type","queryType","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_data"},"columns":{"type":"array","items":{"type":"string"},"default":[]},"rowCount":{"type":"number","default":0},"sampleRows":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"dataViewId":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_mutation_preview"},"operations":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"successCount":{"type":"number","default":0},"failureCount":{"type":"number","default":0},"affectedConceptIds":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"docs_sources"},"documentReferences":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"path":{"type":"string"},"pageId":{"type":["string","null"]}},"required":["title","path"]}}},"required":["id","evidenceId","type","documentReferences"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"background_runs"},"runs":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"entityId":{"type":["string","null"]},"status":{"type":"string"},"percentage":{"type":["number","null"]},"label":{"type":["string","null"]},"error":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["runId","name","domain","status"]}}},"required":["id","evidenceId","type","runs"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_segments"},"title":{"type":"string"},"silhouetteScore":{"type":["number","null"]},"segments":{"type":"array","items":{"type":"object","properties":{"segment":{"type":"number"},"label":{"type":"string"},"description":{"type":["string","null"]},"environments":{"type":"array","items":{"type":"string"}}},"required":["segment","label","environments"]}},"points":{"type":"array","items":{"type":"object","properties":{"envKey":{"type":"string"},"x":{"type":"number"},"y":{"type":"number"},"segment":{"type":"number"}},"required":["envKey","x","y","segment"]}}},"required":["id","evidenceId","type","title","segments","points"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_comparison"},"title":{"type":"string"},"sliceLabel":{"type":"string"},"baselineLabel":{"type":"string"},"sliceEnvCount":{"type":"number"},"baselineEnvCount":{"type":"number"},"edges":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"sliceAgreement":{"type":"number"},"baselineAgreement":{"type":"number"},"sliceStrength":{"type":["number","null"]},"baselineStrength":{"type":["number","null"]},"verdict":{"type":"string","enum":["slice-only","missing-from-slice","differs","consistent"]}},"required":["source","target","sliceAgreement","baselineAgreement","verdict"]}}},"required":["id","evidenceId","type","title","sliceLabel","baselineLabel","sliceEnvCount","baselineEnvCount","edges"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_coverage"},"title":{"type":"string"},"environments":{"type":"array","items":{"type":"object","properties":{"envKey":{"type":"string"},"trainingRows":{"type":["number","null"]},"variablesTrained":{"type":["number","null"]},"variablesTotal":{"type":["number","null"]},"missing":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"reason":{"type":["string","null"]}},"required":["name"]}},"evaluation":{"type":["string","null"]}},"required":["envKey","missing"]}}},"required":["id","evidenceId","type","title","environments"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"clarification"},"toolCallId":{"type":"string"},"mode":{"type":"string","enum":["multiple_choice","form"]},"question":{"type":"string"},"why":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"preview":{"type":["string","null"]}},"required":["label","value"]},"default":[]},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"type":{"type":"string","enum":["number","string","select","multiselect","boolean","source","dataset","digitalTwin","ontologyConcept"],"default":"string"},"default":{"anyOf":[{},{"type":"null"}]},"options":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"value":{"type":"string"},"label":{"type":["string","null"]}},"required":["value"]}]}},{"type":"null"}]},"min":{"type":["number","null"]},"max":{"type":["number","null"]},"step":{"type":["number","null"]},"pattern":{"type":["string","null"]},"control":{"type":["string","null"]},"placeholder":{"type":["string","null"]},"help":{"type":["string","null"]},"required":{"type":["boolean","null"]},"secret":{"type":["boolean","null"]},"urlParam":{"type":["string","null"]}},"required":["id"]},"default":[]},"selectedValues":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"selectedFieldValues":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["id","evidenceId","type","toolCallId","mode","question"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"action_confirmation"},"toolCallId":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"severity":{"type":"string","enum":["mutates_truth","long_running","irreversible"]},"actionLabel":{"type":"string"},"estimatedDuration":{"type":["string","null"]},"changes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"before":{"type":["string","null"]},"after":{"type":["string","null"]}},"required":["label"]}},{"type":"null"}]},"details":{"type":["string","null"]},"editableKind":{"anyOf":[{"type":"string","enum":["extraction_schema"]},{"type":"null"}]},"editableInputs":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"toolName":{"type":["string","null"]},"toolInputs":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}},"required":["id","evidenceId","type","toolCallId","title","summary","severity","actionLabel"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"navigation"},"commandId":{"type":"string"},"label":{"type":"string"},"subtitle":{"type":["string","null"]},"kind":{"type":"string","enum":["navigate","create","action"],"default":"navigate"},"entity":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["dataset","dataview","concept","digitalTwin","report","digitalTwinRun"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"]},{"type":"null"}]}},"required":["id","evidenceId","type","commandId","label"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"foundational_ontology_install"},"ontologyId":{"type":"string"},"version":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"trustTier":{"type":"string"},"anchorsSummary":{"type":["string","null"]},"conceptCount":{"type":"number"},"sourceCount":{"type":"number"},"suggestedScopeNote":{"type":["string","null"]}},"required":["id","evidenceId","type","ontologyId","version","name","trustTier","conceptCount","sourceCount"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"stat_grid"},"title":{"type":["string","null"]},"stats":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"value":{"type":["string","number"]},"unit":{"type":["string","null"]},"unitId":{"type":["string","null"]},"decimals":{"type":["number","null"]},"change":{"type":["number","null"]},"changePeriod":{"type":["string","null"]},"trend":{"anyOf":[{"type":"string","enum":["up","down","neutral"]},{"type":"null"}]}},"required":["title","value"]}},"gridCols":{"anyOf":[{"type":"number","enum":[2,3,4]},{"type":"null"}]}},"required":["id","evidenceId","type","stats"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"markdown"},"content":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"heading"},"text":{"type":["string","null"]},"eyebrow":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"divider"},"style":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"image"},"src":{"type":["string","null"]},"alt":{"type":["string","null"]},"caption":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"iframe"},"url":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"application"},"applicationId":{"type":"string"},"runId":{"type":["string","null"]},"name":{"type":["string","null"]},"status":{"type":["string","null"]},"moduleCount":{"type":["number","null"]},"publicUrl":{"type":["string","null"]}},"required":["id","evidenceId","type","applicationId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"report"},"reportId":{"type":"string"},"title":{"type":["string","null"]},"status":{"type":["string","null"]},"rev":{"type":["number","null"]}},"required":["id","evidenceId","type","reportId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"lineage"},"lineageId":{"type":"string"},"tool":{"type":"string","default":""},"hops":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","default":""}},"required":["kind","id"]},"status":{"type":"string","enum":["resolved","denied","deleted"]},"parents":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","default":""}},"required":["kind","id"]},"default":[]},"pin":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"versionId":{"type":["string","null"]},"ordinal":{"type":["number","null"]},"deltaVersion":{"type":["number","null"]},"label":{"type":["string","null"]}},"required":["kind","id"]},{"type":"null"}]},"detail":{"type":"object","additionalProperties":{},"default":{}}},"required":["ref","status"]},"default":[]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":["number","null"]},"valueType":{"type":["string","null"]},"unit":{"type":["string","null"]},"display":{"type":["string","null"]}}},{"type":"null"}]},"request":{"anyOf":[{"type":"object","properties":{"sql":{"type":["string","null"]},"query":{"type":["string","null"]}}},{"type":"null"}]}},"required":["id","evidenceId","type","lineageId"]}],"discriminator":{"propertyName":"type"}}},"evidenceIds":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"status":{"$ref":"#/components/schemas/ReportStatusSchema"},"rev":{"type":"integer"},"error":{"type":["string","null"]},"prompt":{"type":["string","null"]},"publish":{"anyOf":[{"$ref":"#/components/schemas/reportPublishSchema"},{"type":"null"}]}},"required":["workspaceId","organisationId","title","markdown","widgets","evidenceIds","createdAt","updatedAt"]},"DataViewSchema":{"type":"object","properties":{"_id":{"type":"string"},"organisationId":{"type":"string"},"workspaceId":{"type":"string"},"ownerId":{"type":"string"},"name":{"type":"string"},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"rowCount":{"type":["number","null"]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceSchema"}},"operations":{"type":"array","items":{"$ref":"#/components/schemas/OperationSchema"}},"anchorConceptId":{"type":["string","null"]},"createdBy":{"anyOf":[{"$ref":"#/components/schemas/DataViewCreatedByEnum"},{"type":"null"}]},"sourceQuery":{"anyOf":[{"$ref":"#/components/schemas/DataViewSourceQuerySchema"},{"type":"null"}]},"sourceQueryDetached":{"type":["boolean","null"]},"chartWidgets":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"layout":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},"widget":{"type":"object","additionalProperties":{}}},"required":["id","layout","widget"]}},{"type":"null"}]},"conceptOverrides":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ViewConceptOverrideEntrySchema"}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["ok","broken"]},{"type":"null"}]},"brokenReasons":{"anyOf":[{"type":"array","items":{"type":"string","enum":["source_removed","ontology_reset"]}},{"type":"null"}]},"brokenDependencies":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/BrokenDataViewDependencySchema"}},{"type":"null"}]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["_id","organisationId","workspaceId","ownerId","name","sources","operations"]},"SourceSchema":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"DATASET"},"name":{"type":["string","null"]},"conceptIds":{"type":"array","items":{"type":"string"}},"conceptVersions":{"anyOf":[{"type":"object","additionalProperties":{"type":"integer","minimum":0}},{"type":"null"}]},"version":{"anyOf":[{"$ref":"#/components/schemas/SourcePinSchema"},{"type":"null"}]}},"required":["id","type","conceptIds"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"DATA_VIEW"},"name":{"type":["string","null"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"CONCEPT"},"name":{"type":["string","null"]},"prioritiseCalculation":{"type":"boolean","default":true},"showCalculationColumns":{"type":"boolean","default":false}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"GEO_SIDECAR"},"name":{"type":["string","null"]},"conceptId":{"type":"string"},"sidecarKey":{"type":"string"}},"required":["id","type","conceptId","sidecarKey"]}],"discriminator":{"propertyName":"type"}},"SourcePinSchema":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"latest"}},"required":["kind"]},{"type":"object","properties":{"kind":{"type":"string","const":"pinned"},"versionId":{"type":"string"}},"required":["kind","versionId"]}],"discriminator":{"propertyName":"kind"}},"OperationSchema":{"type":"object","properties":{"id":{"type":"string"},"sourceId":{"type":"string"},"config":{"$ref":"#/components/schemas/OperationConfigSchema"}},"required":["id","sourceId","config"]},"OperationConfigSchema":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"FILTER"},"filterGroup":{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]}},"required":["type","filterGroup"]},{"type":"object","properties":{"type":{"type":"string","const":"AGGREGATE"},"groupByColumns":{"type":"array","items":{"type":"string"}},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}}},"required":["type","groupByColumns","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"JOIN"},"joinType":{"$ref":"#/components/schemas/JoinTypeEnum"},"columnPairs":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/JoinColumnPairSchema"}},{"type":"null"}]},"leftField":{"type":["string","null"]},"rightField":{"type":["string","null"]},"conflictResolution":{"$ref":"#/components/schemas/JoinConflictResolutionEnum"},"leftPrefix":{"type":["string","null"]},"rightPrefix":{"type":["string","null"]}},"required":["type","joinType","conflictResolution"]},{"type":"object","properties":{"type":{"type":"string","const":"CONCATENATE"},"topSource":{"type":["string","null"]},"bottomSource":{"type":["string","null"]},"sources":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"columnMapping":{"type":"object","additionalProperties":{"type":"string"}},"unmatchedRule":{"$ref":"#/components/schemas/UnmatchedRuleEnum"},"discriminatorColumn":{"type":["string","null"]},"discriminatorValues":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["type","columnMapping","unmatchedRule"]},{"type":"object","properties":{"type":{"type":"string","const":"SORT"},"sortColumns":{"type":"array","items":{"$ref":"#/components/schemas/SortColumnSchema"}}},"required":["type","sortColumns"]},{"type":"object","properties":{"type":{"type":"string","const":"SQL_QUERY"},"query":{"type":"string"},"columnSourceAliases":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["type","query"]},{"type":"object","properties":{"type":{"type":"string","const":"SPLIT_COLUMN"},"columnToSplit":{"type":"string"},"splitType":{"$ref":"#/components/schemas/SplitTypeEnum"},"delimiter":{"type":["string","null"]},"columns":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/NewColumnDefinitionSchema"}},{"type":"null"}]}},"required":["type","columnToSplit","splitType"]},{"type":"object","properties":{"type":{"type":"string","const":"DROP_COLUMNS"},"columns":{"type":"array","items":{"type":"string"}}},"required":["type","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"REMOVE_DUPLICATES"},"column":{"type":["string","null"]},"keep":{"$ref":"#/components/schemas/KeepEnum","default":"first"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"IMPUTE_NULLS"},"method":{"$ref":"#/components/schemas/ImputeMethodEnum","default":"constant"},"column":{"type":["string","null"]},"fillValue":{"anyOf":[{"type":["string","number","boolean"]},{"type":"null"}]},"imputations":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"method":{"$ref":"#/components/schemas/ImputeMethodEnum","default":"constant"},"fillValue":{"anyOf":[{"type":["string","number","boolean"]},{"type":"null"}]}},"required":["column"]}},{"type":"null"}]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"DROP_NULLS"},"axis":{"type":"string","enum":["rows","empty_columns"],"default":"rows"},"column":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"string"},"default":[]},"nullThresholdPercent":{"type":"number","default":100}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"REPLACE_VALUES"},"column":{"type":"string"},"mapping":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["type","column","mapping"]},{"type":"object","properties":{"type":{"type":"string","const":"REPLACE_TYPE"},"changes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"toType":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"toSubType":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"dateFormat":{"type":["string","null"]}},"required":["column","toType"]}},{"type":"null"}]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"INTERPOLATE_TIME"},"column":{"type":"string"},"frequency":{"type":"string"},"method":{"$ref":"#/components/schemas/InterpolateTimeMethodEnum"}},"required":["type","column","frequency","method"]},{"type":"object","properties":{"type":{"type":"string","const":"CLIP_OUTLIERS"},"column":{"type":"string"},"lowerQuantile":{"type":"number","default":0.05},"upperQuantile":{"type":"number","default":0.95}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"NORMALIZE_NUMERIC"},"column":{"type":"string"},"method":{"$ref":"#/components/schemas/NormalizeNumericMethodEnum","default":"z_score"}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"MAP_CATEGORIES"},"column":{"type":"string"},"mapping":{"type":"object","additionalProperties":{"type":"string"}},"defaultValue":{"type":["string","null"]}},"required":["type","column","mapping"]},{"type":"object","properties":{"type":{"type":"string","const":"TIME_SERIES_AGGREGATE"},"timeColumn":{"type":"string"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}},"dateFormat":{"anyOf":[{"$ref":"#/components/schemas/DatetimeFormatSchema"},{"type":"null"}]}},"required":["type","timeColumn","granularity","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"TIME_SERIES_JOIN"},"joinType":{"$ref":"#/components/schemas/JoinTypeEnum"},"leftTimeColumn":{"type":"string"},"rightTimeColumn":{"type":"string"},"rightSource":{"type":"string"},"strategy":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"granularity"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]}},"required":["type","granularity"]},{"type":"object","properties":{"type":{"type":"string","const":"asOf"},"direction":{"$ref":"#/components/schemas/AsOfDirectionEnum"},"tolerance":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"$ref":"#/components/schemas/ToleranceUnitEnum"}},"required":["value","unit"]},{"type":"null"}]}},"required":["type","direction"]},{"type":"object","properties":{"type":{"type":"string","const":"interval"},"leftEndColumn":{"type":"string"}},"required":["type","leftEndColumn"]}],"discriminator":{"propertyName":"type"}},"exactMatchKeys":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"leftField":{"type":"string"},"rightField":{"type":"string"}},"required":["leftField","rightField"]}},{"type":"null"}]},"multiMatch":{"$ref":"#/components/schemas/MultiMatchStrategyEnum"},"multiMatchAggregations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}},{"type":"null"}]}},"required":["type","joinType","leftTimeColumn","rightTimeColumn","rightSource","strategy","multiMatch"]},{"type":"object","properties":{"type":{"type":"string","const":"TRANSPOSE"},"timeColumn":{"type":"string"},"envColumns":{"type":"array","items":{"type":"string"}},"valueColumns":{"type":"array","items":{"type":"string"}},"columnTemplate":{"type":"string"},"joinStrategy":{"anyOf":[{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"granularity"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]}},"required":["type","granularity"]},{"type":"object","properties":{"type":{"type":"string","const":"asOf"},"direction":{"$ref":"#/components/schemas/AsOfDirectionEnum"},"tolerance":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"$ref":"#/components/schemas/ToleranceUnitEnum"}},"required":["value","unit"]},{"type":"null"}]}},"required":["type","direction"]}],"discriminator":{"propertyName":"type"}},{"type":"null"}]}},"required":["type","timeColumn","envColumns","valueColumns","columnTemplate"]},{"type":"object","properties":{"type":{"type":"string","const":"FREQUENCY_ANALYSIS"},"timeColumn":{"type":"string"},"valueColumns":{"type":"array","items":{"type":"string"}},"method":{"$ref":"#/components/schemas/FrequencyMethodEnum"},"windowFunction":{"$ref":"#/components/schemas/FrequencyWindowFunctionEnum","default":"hann"},"windowSize":{"type":["number","null"]},"overlap":{"type":"number","default":0.5},"samplingRateHz":{"type":["number","null"]},"outputFormat":{"$ref":"#/components/schemas/FrequencyOutputFormatEnum"},"frequencyRange":{"anyOf":[{"type":"object","properties":{"minHz":{"type":["number","null"]},"maxHz":{"type":["number","null"]}}},{"type":"null"}]},"frequencyUnit":{"$ref":"#/components/schemas/FrequencyUnitEnum","default":"hz"}},"required":["type","timeColumn","valueColumns","method","outputFormat"]},{"type":"object","properties":{"type":{"type":"string","const":"CYCLIC_AGGREGATE"},"timeColumn":{"type":"string"},"cycleComponent":{"$ref":"#/components/schemas/CyclicComponentEnum"},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}}},"required":["type","timeColumn","cycleComponent","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"DIFF"},"timeColumn":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"partitionColumns":{"type":"array","items":{"type":"string"},"default":[]},"outputSuffix":{"type":"string","default":"_diff"},"replaceColumns":{"type":"boolean","default":false}},"required":["type","timeColumn","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"DATE_DIFF"},"startColumn":{"type":"string"},"endColumn":{"type":"string"},"unit":{"$ref":"#/components/schemas/DateDiffUnitEnum","default":"days"},"sign":{"$ref":"#/components/schemas/DateDiffSignEnum","default":"signed"},"outputColumn":{"type":["string","null"]}},"required":["type","startColumn","endColumn"]},{"type":"object","properties":{"type":{"type":"string","const":"CUMULATIVE"},"timeColumn":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"partitionColumns":{"type":"array","items":{"type":"string"},"default":[]},"outputSuffix":{"type":"string","default":"_cumsum"},"replaceColumns":{"type":"boolean","default":false}},"required":["type","timeColumn","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_DECOMPOSE"},"column":{"type":"string"},"mode":{"$ref":"#/components/schemas/ArrayDecomposeModeEnum","default":"position"},"maxColumns":{"type":"integer","exclusiveMinimum":0,"default":500},"outputPrefix":{"type":"string","default":"_"}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_CONSOLIDATE"},"groups":{"type":"array","items":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"string"},"minItems":1},"outputColumn":{"type":"string"},"dropSource":{"type":"boolean","default":true},"includeNulls":{"type":"boolean","default":false}},"required":["columns","outputColumn"]},"minItems":1}},"required":["type","groups"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_EXPLODE"},"column":{"type":"string"},"outputColumn":{"type":["string","null"]},"preserveIndex":{"type":"boolean","default":false}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_AGGREGATE"},"column":{"type":"string"},"aggregation":{"$ref":"#/components/schemas/ArrayAggregationKindEnum"},"outputColumn":{"type":["string","null"]}},"required":["type","column","aggregation"]},{"type":"object","properties":{"type":{"type":"string","const":"JSON_FLATTEN"},"column":{"type":"string"},"maxColumns":{"type":"integer","exclusiveMinimum":0,"default":500},"separator":{"type":"string","default":"."},"dropSource":{"type":"boolean","default":true}},"required":["type","column"]}],"discriminator":{"propertyName":"type"}},"FilterSchema":{"type":"object","properties":{"column":{"type":"string"},"comparisonOperator":{"$ref":"#/components/schemas/ComparisonOperatorEnum"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":["string","number","boolean"]}}]},"correctType":{"type":"boolean"}},"required":["column","comparisonOperator","value","correctType"]},"ComparisonOperatorEnum":{"type":"string","enum":["Equal to","Not Equal to","Contains","Does not contain","Starts with","Ends with","Is Empty","Is not Empty","Less than","Greater than","Less than or equal to","Greater than or equal to","Before","After","Array contains","Array contains any","Array contains all","Array does not contain","Array does not contain any","Array does not contain all","Array size equal to","Array size greater than","Array size less than"]},"FilterGroupSchema":{"type":"object","properties":{"booleanOperator":{"$ref":"#/components/schemas/LogicalOperatorEnum"},"filters":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]}}},"required":["booleanOperator","filters"]},"LogicalOperatorEnum":{"type":"string","enum":["AND","OR"]},"AggregationFunctionSchema":{"type":"object","properties":{"column":{"type":"string"},"function":{"$ref":"#/components/schemas/AggregateFunctionEnum"},"alias":{"type":["string","null"]},"filter":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]},{"type":"null"}]}},"required":["column","function"]},"AggregateFunctionEnum":{"type":"string","enum":["sum","avg","min","max","count","countDistinct","first","last","categoryShare"]},"JoinTypeEnum":{"type":"string","enum":["inner","left","right","full"]},"JoinColumnPairSchema":{"type":"object","properties":{"leftField":{"type":"string"},"rightField":{"type":"string"}},"required":["leftField","rightField"]},"JoinConflictResolutionEnum":{"type":"string","enum":["keep_left","keep_right","prefix"]},"UnmatchedRuleEnum":{"type":"string","enum":["error","drop","append"]},"SortColumnSchema":{"type":"object","properties":{"column":{"type":"string"},"direction":{"$ref":"#/components/schemas/SortDirectionEnum"}},"required":["column","direction"]},"SortDirectionEnum":{"type":"string","enum":["asc","desc"]},"SplitTypeEnum":{"type":"string","enum":["delimiter","pattern"]},"NewColumnDefinitionSchema":{"type":"object","properties":{"name":{"type":"string"},"pattern":{"type":["string","null"]}},"required":["name"]},"KeepEnum":{"type":"string","enum":["first","last"]},"ImputeMethodEnum":{"type":"string","enum":["mean","median","mode","constant"]},"SchemaMainTypeEnum":{"type":"string","enum":["None","String","Category","Number","Boolean","DateTime","Array","Unknown"]},"SchemaSubTypeEnum":{"type":"string","enum":["Integer","Float","UnsignedInteger","UnsignedFloat","String","Number","Category","Boolean","DateTime"]},"InterpolateTimeMethodEnum":{"type":"string","enum":["linear","time","index"]},"NormalizeNumericMethodEnum":{"type":"string","enum":["min_max","z_score"]},"DatetimeFormatSchema":{"type":"string","minLength":1},"AsOfDirectionEnum":{"type":"string","enum":["backward","forward","nearest"]},"ToleranceUnitEnum":{"type":"string","enum":["us","ms","s","m","h","d"]},"MultiMatchStrategyEnum":{"type":"string","enum":["first","last","aggregate"]},"FrequencyMethodEnum":{"type":"string","enum":["fft","welch"]},"FrequencyWindowFunctionEnum":{"type":"string","enum":["hann","hamming","blackman","rectangular"]},"FrequencyOutputFormatEnum":{"type":"string","enum":["spectrogram","time_frequency_long"]},"FrequencyUnitEnum":{"type":"string","enum":["hz","per_minute","per_hour","per_day","per_week","per_month","per_year"]},"CyclicComponentEnum":{"type":"string","enum":["second_in_minute","minute_in_hour","hour_of_day","day_of_week","day_of_month","week_of_year","month_of_year","quarter_of_year"]},"DateDiffUnitEnum":{"type":"string","enum":["seconds","minutes","hours","days","weeks"]},"DateDiffSignEnum":{"type":"string","enum":["signed","absolute"]},"ArrayDecomposeModeEnum":{"type":"string","enum":["position","one_hot"]},"ArrayAggregationKindEnum":{"type":"string","enum":["mean","sum","min","max","median","count"]},"DataViewCreatedByEnum":{"type":"string","enum":["manual","ontology_query","ai","recommended"]},"DataViewSourceQuerySchema":{"type":"object","properties":{"queryRequest":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"reconciliationColumnSides":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ReconciliationColumnSideEnum"}},{"type":"null"}]},"reconciliationColumnGroups":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ReconciliationColumnGroupSchema"}},{"type":"null"}]},"reconciliationSecondaries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ReconciliationSecondaryMetaSchema"}},{"type":"null"}]},"reconciliationAlignKeyLabels":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"additionalProperties":true},"ReconciliationColumnSideEnum":{"type":"string","enum":["primary","secondary","system","context"]},"ReconciliationColumnGroupSchema":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"fieldIds":{"type":"array","items":{"type":"string"}}},"required":["key","label","fieldIds"]},"ReconciliationSecondaryMetaSchema":{"type":"object","properties":{"secondaryKey":{"type":"string"},"secondaryName":{"type":"string"},"presenceCol":{"type":["string","null"]},"mismatchCol":{"type":["string","null"]},"statusCol":{"type":["string","null"]}},"required":["secondaryKey","secondaryName"]},"ViewConceptOverrideEntrySchema":{"type":"object","properties":{"override":{"type":"object","additionalProperties":{}},"displayName":{"type":["string","null"]},"description":{"type":["string","null"]},"lineageHash":{"type":["string","null"]},"lastEditedBy":{"type":["string","null"]},"lastEditedAt":{"type":["string","null"]}},"required":["override"]},"BrokenDataViewDependencySchema":{"type":"object","properties":{"type":{"type":"string","enum":["DATASET","DATA_VIEW"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"]},"ReportStatusSchema":{"type":"string","enum":["draft","ready","error"]},"reportPublishSchema":{"type":"object","properties":{"slug":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"consumerAccess":{"anyOf":[{"type":"string","enum":["private","workspace","organisation","public"]},{"type":"null"}]},"resolvedInputs":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"datasetId":{"type":"string"},"versionId":{"type":["string","null"]},"deltaVersion":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["datasetId"]}},{"type":"null"}]},"widgetSnapshot":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":{}}},{"type":"null"}]},"snapshotAt":{"type":["string","null"]},"snapshotStats":{"anyOf":[{"type":"object","properties":{"requested":{"type":"number"},"resolved":{"type":"number"},"omitted":{"type":"number"},"timedOut":{"type":"boolean"},"bytes":{"type":"number"}},"required":["requested","resolved","omitted","timedOut","bytes"]},{"type":"null"}]}}}},"responses":{"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"429":{"description":"Too Many Requests; the response carries Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}}}},"paths":{"/api/v1/workspaces/{wsId}/reports":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-reports","summary":"Create report","description":"Creates a new report. Body: title, optional description. Report is created in draft status with empty markdown, widgets, and evidenceIds. Stored in platform MongoDB; content is written via PATCH or by the agent's report tools.","tags":["Reports"],"parameters":[{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReportInput"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportEnvelope"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Get report

> Returns the report by id from platform MongoDB. Must belong to the workspace.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Reports"}],"servers":[{"url":"https://sandbox.rootcause.ai","description":"Sandbox"},{"url":"https://platform.rootcause.ai","description":"Production"},{"url":"http://localhost:3000","description":"Local development"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one."}},"schemas":{"ReportEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Report"}},"required":["data"]},"Report":{"type":"object","properties":{"id":{"type":["string","null"]},"workspaceId":{"type":"string"},"organisationId":{"type":"string"},"title":{"type":"string"},"markdown":{"type":"string"},"widgets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"chart"},"explorerConfig":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"dataView":{"anyOf":[{"$ref":"#/components/schemas/DataViewSchema"},{"type":"null"}]},"operations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/OperationSchema"}},{"type":"null"}]},"additionalSources":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SourceSchema"}},{"type":"null"}]},"inlineData":{"anyOf":[{"type":"object","properties":{"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["None","String","Category","Number","Boolean","DateTime","Array","Unknown"]}},"required":["name","type"]},"minItems":1},"rows":{"type":"array","items":{"type":"object","additionalProperties":{"type":["string","number","boolean","null"]}},"default":[]},"downsampled":{"type":"boolean"},"totalRows":{"type":["number","null"]}},"required":["columns"]},{"type":"null"}]},"series":{"anyOf":[{"type":"object","properties":{"labels":{"type":"array","items":{"type":["string","number"]},"default":[]},"datasets":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"meta":{"anyOf":[{"type":"object","properties":{"version":{"type":"number","default":1},"xField":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"]},"default":[]},"series":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"yField":{"type":["string","null"]},"aggregation":{"type":["string","null"]}},"required":["label"]},"default":[]},"categoriesTotal":{"type":["number","null"]},"categoriesShown":{"type":["number","null"]},"otherFolded":{"type":["boolean","null"]},"sortBy":{"type":["string","null"]},"sortType":{"type":["string","null"]},"binCount":{"type":["number","null"]},"linksTotal":{"type":["number","null"]},"linksShown":{"type":["number","null"]},"pointsTotal":{"type":["number","null"]},"pointsShown":{"type":["number","null"]},"rowsScanned":{"type":["number","null"]},"rowsWithoutCategory":{"type":["number","null"]},"rowsExcluded":{"type":["number","null"]},"rowsExcludedBy":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string"},"column":{"type":["string","null"]},"rows":{"type":"number"}},"required":["reason","rows"]}},{"type":"null"}]},"downsampled":{"type":["boolean","null"]},"summary":{"type":"string","default":""}},"additionalProperties":true},{"type":"null"}]}}},{"type":"null"}]},"xSelection":{"type":"string"},"traces":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"bar"},"options":{"anyOf":[{"type":"object","properties":{"stacked":{"type":"boolean","default":false},"aggregation":{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"line"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"anyOf":[{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"},{"type":"null"}]},"tension":{"type":"number","minimum":0,"maximum":1,"default":0.4},"showPoints":{"type":"boolean","default":true}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"scatter"},"options":{"anyOf":[{"type":"object","properties":{"showLine":{"type":"boolean","default":false},"pointRadius":{"type":"number","minimum":1,"maximum":20,"default":3}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"area"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"anyOf":[{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"},{"type":"null"}]},"tension":{"type":"number","minimum":0,"maximum":1,"default":0.4},"fillOpacity":{"type":"number","minimum":0,"maximum":1,"default":0.3}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"histogram"},"options":{"anyOf":[{"type":"object","properties":{"bins":{"type":"number","minimum":5,"maximum":100,"default":20}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"pie"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"default":"sum","type":"string","enum":["average","sum","count","min","max"]}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"doughnut"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"default":"sum","type":"string","enum":["average","sum","count","min","max"]}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"sankey"}},"required":["id","name","ySelection","chartType"]}],"discriminator":{"propertyName":"chartType"}}},"config":{"type":"object","properties":{"responsive":{"type":"boolean","default":true},"chartTitle":{"type":["string","null"]},"dataPoints":{"type":"number","default":-1},"dataDisplayOrder":{"type":"string","enum":["fromStart","fromEnd"],"default":"fromStart"},"sortBy":{"anyOf":[{"type":"string","enum":["none","x","y"]},{"type":"null"}]},"sortType":{"anyOf":[{"type":"string","enum":["ascending","descending","natural"]},{"type":"null"}]},"advancedSettings":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}}}},"required":["id","xSelection","traces","config"]},{"type":"null"}]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"table"},"title":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","additionalProperties":{}}},"rows":{"type":"array","items":{"type":"object","additionalProperties":{}}},"totalRows":{"type":"number"},"csvExport":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"sql_evidence"},"rowCount":{"type":"integer","minimum":0},"queryTruncated":{"type":"boolean"},"queryTotalRowCount":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}},"required":["source","rowCount","queryTruncated"]},{"type":"null"}]},"livePaging":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"anchor_sql"},"sql":{"type":"string"},"projectionMode":{"type":"string","enum":["related","minimal"],"default":"related"}},"required":["source","sql"]},{"type":"null"}]}},"required":["id","evidenceId","type","columns","rows","totalRows"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_preview"},"datasetId":{"type":"string"}},"required":["id","evidenceId","type","datasetId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_view_preview"},"dataViewId":{"type":"string"}},"required":["id","evidenceId","type","dataViewId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"kpi_card"},"title":{"type":"string"},"value":{"type":["string","number"]},"dataBinding":{"anyOf":[{"oneOf":[{"type":"object","properties":{"sourceType":{"type":"string","const":"dataset"},"datasetId":{"type":"string","minLength":1},"valueField":{"type":"string","minLength":1}},"required":["sourceType","datasetId","valueField"]},{"type":"object","properties":{"sourceType":{"type":"string","const":"dataview"},"dataViewId":{"type":"string","minLength":1},"valueField":{"type":"string","minLength":1}},"required":["sourceType","dataViewId","valueField"]}],"discriminator":{"propertyName":"sourceType"}},{"type":"null"}]},"unit":{"type":["string","null"]},"unitId":{"type":["string","null"]},"change":{"type":["number","null"]},"changePeriod":{"type":["string","null"]},"trend":{"anyOf":[{"type":"string","enum":["up","down","neutral"]},{"type":"null"}]}},"required":["id","evidenceId","type","title","value"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_graph"},"digitalTwinVersionId":{"type":"string"}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dataset_search_results"},"searchQuery":{"type":"string"},"datasetIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","datasetIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_view_search_results"},"searchQuery":{"type":"string"},"dataViewIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","dataViewIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_result"},"digitalTwinRunId":{"type":"string"}},"required":["id","evidenceId","type","digitalTwinRunId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_search_results"},"digitalTwinVersionIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","digitalTwinVersionIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_run_search_results"},"searchQuery":{"type":"string"},"runIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","runIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_graph"},"searchQuery":{"type":"string"},"conceptIds":{"type":"array","items":{"type":"string"}},"anchorType":{"type":"string","enum":["dataset","identifier","conceptType"],"default":"dataset"},"showFullGraph":{"type":"boolean","default":false}},"required":["id","evidenceId","type","searchQuery","conceptIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"path_analysis_sankey"},"digitalTwinVersionId":{"type":"string"},"selectedNode":{"type":["string","null"]},"selectedEdge":{"anyOf":[{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},{"type":"null"}]},"depthLimit":{"type":"number","default":2}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"parameter_distribution"},"digitalTwinVersionId":{"type":"string"},"selectedNode":{"type":["string","null"]},"selectedEdge":{"anyOf":[{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},{"type":"null"}]}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_diff"},"version1Id":{"type":"string"},"version2Id":{"type":"string"}},"required":["id","evidenceId","type","version1Id","version2Id"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dose_response"},"causeVariable":{"type":"string"},"sweptMode":{"anyOf":[{"type":"string","enum":["absolute","percentage"]},{"type":"null"}]},"metric":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"causeValue":{"type":"number"},"effect":{"type":"number"},"ciLower":{"type":["number","null"]},"ciUpper":{"type":["number","null"]}},"required":["causeValue","effect"]}},"referenceValue":{"type":["number","null"]},"isLinear":{"type":["boolean","null"]},"inflectionPoints":{"anyOf":[{"type":"array","items":{"type":"number"}},{"type":"null"}]},"digitalTwinRunId":{"type":["string","null"]}},"required":["id","evidenceId","type","causeVariable","metric","points"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"page_context"},"section":{"anyOf":[{"type":"string","enum":["Organisation Home","Workspace Home","Dataset Selection","Dataset Page","Data View Selection","Data View Page","Digital Twin Selection","Digital Twin Page","Report Selection","Report Page","Settings"]},{"type":"null"}]},"summary":{"type":"string"},"entityName":{"type":["string","null"]},"entityType":{"anyOf":[{"type":"string","enum":["dataset","data_view","digital_twin","report"]},{"type":"null"}]},"itemCount":{"type":["number","null"]}},"required":["id","evidenceId","type","summary"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dag_review"},"digitalTwinVersionId":{"type":"string"},"digitalTwinName":{"type":"string"},"nodeCount":{"type":"number"},"edgeCount":{"type":"number"},"overallHealth":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"description":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"suggestedFix":{"type":["string","null"]},"affectedNodes":{"type":"array","items":{"type":"string"},"default":[]},"affectedEdges":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},"default":[]}},"required":["type","description","severity"]},"default":[]},"recommendations":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id","evidenceId","type","digitalTwinVersionId","digitalTwinName","nodeCount","edgeCount","overallHealth"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_context"},"outcomeVariable":{"type":"string"},"relatedConcepts":{"type":"array","items":{"type":"object","properties":{"concept":{"type":"string"},"source":{"type":["string","null"]},"sourceName":{"type":["string","null"]},"role":{"type":["string","null"]},"isIdentifier":{"type":"boolean","default":false}},"required":["concept"]},"default":[]},"datasetSourceCount":{"type":"number","default":0},"recommendation":{"type":["string","null"]},"existingDataViewId":{"type":["string","null"]},"existingDataViewName":{"type":["string","null"]},"existingDigitalTwinId":{"type":["string","null"]},"existingDigitalTwinName":{"type":["string","null"]}},"required":["id","evidenceId","type","outcomeVariable"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"graph_query_result"},"queryType":{"type":"string"},"digitalTwinVersionId":{"type":"string"},"queriedNode":{"type":["string","null"]},"results":{"type":"array","items":{"type":"object","properties":{"node":{"type":"string"},"edgeLabel":{"type":["string","null"]},"strength":{"type":["number","null"]},"depth":{"type":["number","null"]},"type":{"type":["string","null"]}},"required":["node"]},"default":[]},"path":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}},"required":["id","evidenceId","type","queryType","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_data"},"columns":{"type":"array","items":{"type":"string"},"default":[]},"rowCount":{"type":"number","default":0},"sampleRows":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"dataViewId":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_mutation_preview"},"operations":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"successCount":{"type":"number","default":0},"failureCount":{"type":"number","default":0},"affectedConceptIds":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"docs_sources"},"documentReferences":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"path":{"type":"string"},"pageId":{"type":["string","null"]}},"required":["title","path"]}}},"required":["id","evidenceId","type","documentReferences"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"background_runs"},"runs":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"entityId":{"type":["string","null"]},"status":{"type":"string"},"percentage":{"type":["number","null"]},"label":{"type":["string","null"]},"error":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["runId","name","domain","status"]}}},"required":["id","evidenceId","type","runs"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_segments"},"title":{"type":"string"},"silhouetteScore":{"type":["number","null"]},"segments":{"type":"array","items":{"type":"object","properties":{"segment":{"type":"number"},"label":{"type":"string"},"description":{"type":["string","null"]},"environments":{"type":"array","items":{"type":"string"}}},"required":["segment","label","environments"]}},"points":{"type":"array","items":{"type":"object","properties":{"envKey":{"type":"string"},"x":{"type":"number"},"y":{"type":"number"},"segment":{"type":"number"}},"required":["envKey","x","y","segment"]}}},"required":["id","evidenceId","type","title","segments","points"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_comparison"},"title":{"type":"string"},"sliceLabel":{"type":"string"},"baselineLabel":{"type":"string"},"sliceEnvCount":{"type":"number"},"baselineEnvCount":{"type":"number"},"edges":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"sliceAgreement":{"type":"number"},"baselineAgreement":{"type":"number"},"sliceStrength":{"type":["number","null"]},"baselineStrength":{"type":["number","null"]},"verdict":{"type":"string","enum":["slice-only","missing-from-slice","differs","consistent"]}},"required":["source","target","sliceAgreement","baselineAgreement","verdict"]}}},"required":["id","evidenceId","type","title","sliceLabel","baselineLabel","sliceEnvCount","baselineEnvCount","edges"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_coverage"},"title":{"type":"string"},"environments":{"type":"array","items":{"type":"object","properties":{"envKey":{"type":"string"},"trainingRows":{"type":["number","null"]},"variablesTrained":{"type":["number","null"]},"variablesTotal":{"type":["number","null"]},"missing":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"reason":{"type":["string","null"]}},"required":["name"]}},"evaluation":{"type":["string","null"]}},"required":["envKey","missing"]}}},"required":["id","evidenceId","type","title","environments"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"clarification"},"toolCallId":{"type":"string"},"mode":{"type":"string","enum":["multiple_choice","form"]},"question":{"type":"string"},"why":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"preview":{"type":["string","null"]}},"required":["label","value"]},"default":[]},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"type":{"type":"string","enum":["number","string","select","multiselect","boolean","source","dataset","digitalTwin","ontologyConcept"],"default":"string"},"default":{"anyOf":[{},{"type":"null"}]},"options":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"value":{"type":"string"},"label":{"type":["string","null"]}},"required":["value"]}]}},{"type":"null"}]},"min":{"type":["number","null"]},"max":{"type":["number","null"]},"step":{"type":["number","null"]},"pattern":{"type":["string","null"]},"control":{"type":["string","null"]},"placeholder":{"type":["string","null"]},"help":{"type":["string","null"]},"required":{"type":["boolean","null"]},"secret":{"type":["boolean","null"]},"urlParam":{"type":["string","null"]}},"required":["id"]},"default":[]},"selectedValues":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"selectedFieldValues":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["id","evidenceId","type","toolCallId","mode","question"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"action_confirmation"},"toolCallId":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"severity":{"type":"string","enum":["mutates_truth","long_running","irreversible"]},"actionLabel":{"type":"string"},"estimatedDuration":{"type":["string","null"]},"changes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"before":{"type":["string","null"]},"after":{"type":["string","null"]}},"required":["label"]}},{"type":"null"}]},"details":{"type":["string","null"]},"editableKind":{"anyOf":[{"type":"string","enum":["extraction_schema"]},{"type":"null"}]},"editableInputs":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"toolName":{"type":["string","null"]},"toolInputs":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}},"required":["id","evidenceId","type","toolCallId","title","summary","severity","actionLabel"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"navigation"},"commandId":{"type":"string"},"label":{"type":"string"},"subtitle":{"type":["string","null"]},"kind":{"type":"string","enum":["navigate","create","action"],"default":"navigate"},"entity":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["dataset","dataview","concept","digitalTwin","report","digitalTwinRun"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"]},{"type":"null"}]}},"required":["id","evidenceId","type","commandId","label"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"foundational_ontology_install"},"ontologyId":{"type":"string"},"version":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"trustTier":{"type":"string"},"anchorsSummary":{"type":["string","null"]},"conceptCount":{"type":"number"},"sourceCount":{"type":"number"},"suggestedScopeNote":{"type":["string","null"]}},"required":["id","evidenceId","type","ontologyId","version","name","trustTier","conceptCount","sourceCount"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"stat_grid"},"title":{"type":["string","null"]},"stats":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"value":{"type":["string","number"]},"unit":{"type":["string","null"]},"unitId":{"type":["string","null"]},"decimals":{"type":["number","null"]},"change":{"type":["number","null"]},"changePeriod":{"type":["string","null"]},"trend":{"anyOf":[{"type":"string","enum":["up","down","neutral"]},{"type":"null"}]}},"required":["title","value"]}},"gridCols":{"anyOf":[{"type":"number","enum":[2,3,4]},{"type":"null"}]}},"required":["id","evidenceId","type","stats"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"markdown"},"content":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"heading"},"text":{"type":["string","null"]},"eyebrow":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"divider"},"style":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"image"},"src":{"type":["string","null"]},"alt":{"type":["string","null"]},"caption":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"iframe"},"url":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"application"},"applicationId":{"type":"string"},"runId":{"type":["string","null"]},"name":{"type":["string","null"]},"status":{"type":["string","null"]},"moduleCount":{"type":["number","null"]},"publicUrl":{"type":["string","null"]}},"required":["id","evidenceId","type","applicationId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"report"},"reportId":{"type":"string"},"title":{"type":["string","null"]},"status":{"type":["string","null"]},"rev":{"type":["number","null"]}},"required":["id","evidenceId","type","reportId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"lineage"},"lineageId":{"type":"string"},"tool":{"type":"string","default":""},"hops":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","default":""}},"required":["kind","id"]},"status":{"type":"string","enum":["resolved","denied","deleted"]},"parents":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","default":""}},"required":["kind","id"]},"default":[]},"pin":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"versionId":{"type":["string","null"]},"ordinal":{"type":["number","null"]},"deltaVersion":{"type":["number","null"]},"label":{"type":["string","null"]}},"required":["kind","id"]},{"type":"null"}]},"detail":{"type":"object","additionalProperties":{},"default":{}}},"required":["ref","status"]},"default":[]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":["number","null"]},"valueType":{"type":["string","null"]},"unit":{"type":["string","null"]},"display":{"type":["string","null"]}}},{"type":"null"}]},"request":{"anyOf":[{"type":"object","properties":{"sql":{"type":["string","null"]},"query":{"type":["string","null"]}}},{"type":"null"}]}},"required":["id","evidenceId","type","lineageId"]}],"discriminator":{"propertyName":"type"}}},"evidenceIds":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"status":{"$ref":"#/components/schemas/ReportStatusSchema"},"rev":{"type":"integer"},"error":{"type":["string","null"]},"prompt":{"type":["string","null"]},"publish":{"anyOf":[{"$ref":"#/components/schemas/reportPublishSchema"},{"type":"null"}]}},"required":["workspaceId","organisationId","title","markdown","widgets","evidenceIds","createdAt","updatedAt"]},"DataViewSchema":{"type":"object","properties":{"_id":{"type":"string"},"organisationId":{"type":"string"},"workspaceId":{"type":"string"},"ownerId":{"type":"string"},"name":{"type":"string"},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"rowCount":{"type":["number","null"]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceSchema"}},"operations":{"type":"array","items":{"$ref":"#/components/schemas/OperationSchema"}},"anchorConceptId":{"type":["string","null"]},"createdBy":{"anyOf":[{"$ref":"#/components/schemas/DataViewCreatedByEnum"},{"type":"null"}]},"sourceQuery":{"anyOf":[{"$ref":"#/components/schemas/DataViewSourceQuerySchema"},{"type":"null"}]},"sourceQueryDetached":{"type":["boolean","null"]},"chartWidgets":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"layout":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},"widget":{"type":"object","additionalProperties":{}}},"required":["id","layout","widget"]}},{"type":"null"}]},"conceptOverrides":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ViewConceptOverrideEntrySchema"}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["ok","broken"]},{"type":"null"}]},"brokenReasons":{"anyOf":[{"type":"array","items":{"type":"string","enum":["source_removed","ontology_reset"]}},{"type":"null"}]},"brokenDependencies":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/BrokenDataViewDependencySchema"}},{"type":"null"}]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["_id","organisationId","workspaceId","ownerId","name","sources","operations"]},"SourceSchema":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"DATASET"},"name":{"type":["string","null"]},"conceptIds":{"type":"array","items":{"type":"string"}},"conceptVersions":{"anyOf":[{"type":"object","additionalProperties":{"type":"integer","minimum":0}},{"type":"null"}]},"version":{"anyOf":[{"$ref":"#/components/schemas/SourcePinSchema"},{"type":"null"}]}},"required":["id","type","conceptIds"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"DATA_VIEW"},"name":{"type":["string","null"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"CONCEPT"},"name":{"type":["string","null"]},"prioritiseCalculation":{"type":"boolean","default":true},"showCalculationColumns":{"type":"boolean","default":false}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"GEO_SIDECAR"},"name":{"type":["string","null"]},"conceptId":{"type":"string"},"sidecarKey":{"type":"string"}},"required":["id","type","conceptId","sidecarKey"]}],"discriminator":{"propertyName":"type"}},"SourcePinSchema":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"latest"}},"required":["kind"]},{"type":"object","properties":{"kind":{"type":"string","const":"pinned"},"versionId":{"type":"string"}},"required":["kind","versionId"]}],"discriminator":{"propertyName":"kind"}},"OperationSchema":{"type":"object","properties":{"id":{"type":"string"},"sourceId":{"type":"string"},"config":{"$ref":"#/components/schemas/OperationConfigSchema"}},"required":["id","sourceId","config"]},"OperationConfigSchema":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"FILTER"},"filterGroup":{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]}},"required":["type","filterGroup"]},{"type":"object","properties":{"type":{"type":"string","const":"AGGREGATE"},"groupByColumns":{"type":"array","items":{"type":"string"}},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}}},"required":["type","groupByColumns","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"JOIN"},"joinType":{"$ref":"#/components/schemas/JoinTypeEnum"},"columnPairs":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/JoinColumnPairSchema"}},{"type":"null"}]},"leftField":{"type":["string","null"]},"rightField":{"type":["string","null"]},"conflictResolution":{"$ref":"#/components/schemas/JoinConflictResolutionEnum"},"leftPrefix":{"type":["string","null"]},"rightPrefix":{"type":["string","null"]}},"required":["type","joinType","conflictResolution"]},{"type":"object","properties":{"type":{"type":"string","const":"CONCATENATE"},"topSource":{"type":["string","null"]},"bottomSource":{"type":["string","null"]},"sources":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"columnMapping":{"type":"object","additionalProperties":{"type":"string"}},"unmatchedRule":{"$ref":"#/components/schemas/UnmatchedRuleEnum"},"discriminatorColumn":{"type":["string","null"]},"discriminatorValues":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["type","columnMapping","unmatchedRule"]},{"type":"object","properties":{"type":{"type":"string","const":"SORT"},"sortColumns":{"type":"array","items":{"$ref":"#/components/schemas/SortColumnSchema"}}},"required":["type","sortColumns"]},{"type":"object","properties":{"type":{"type":"string","const":"SQL_QUERY"},"query":{"type":"string"},"columnSourceAliases":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["type","query"]},{"type":"object","properties":{"type":{"type":"string","const":"SPLIT_COLUMN"},"columnToSplit":{"type":"string"},"splitType":{"$ref":"#/components/schemas/SplitTypeEnum"},"delimiter":{"type":["string","null"]},"columns":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/NewColumnDefinitionSchema"}},{"type":"null"}]}},"required":["type","columnToSplit","splitType"]},{"type":"object","properties":{"type":{"type":"string","const":"DROP_COLUMNS"},"columns":{"type":"array","items":{"type":"string"}}},"required":["type","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"REMOVE_DUPLICATES"},"column":{"type":["string","null"]},"keep":{"$ref":"#/components/schemas/KeepEnum","default":"first"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"IMPUTE_NULLS"},"method":{"$ref":"#/components/schemas/ImputeMethodEnum","default":"constant"},"column":{"type":["string","null"]},"fillValue":{"anyOf":[{"type":["string","number","boolean"]},{"type":"null"}]},"imputations":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"method":{"$ref":"#/components/schemas/ImputeMethodEnum","default":"constant"},"fillValue":{"anyOf":[{"type":["string","number","boolean"]},{"type":"null"}]}},"required":["column"]}},{"type":"null"}]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"DROP_NULLS"},"axis":{"type":"string","enum":["rows","empty_columns"],"default":"rows"},"column":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"string"},"default":[]},"nullThresholdPercent":{"type":"number","default":100}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"REPLACE_VALUES"},"column":{"type":"string"},"mapping":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["type","column","mapping"]},{"type":"object","properties":{"type":{"type":"string","const":"REPLACE_TYPE"},"changes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"toType":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"toSubType":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"dateFormat":{"type":["string","null"]}},"required":["column","toType"]}},{"type":"null"}]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"INTERPOLATE_TIME"},"column":{"type":"string"},"frequency":{"type":"string"},"method":{"$ref":"#/components/schemas/InterpolateTimeMethodEnum"}},"required":["type","column","frequency","method"]},{"type":"object","properties":{"type":{"type":"string","const":"CLIP_OUTLIERS"},"column":{"type":"string"},"lowerQuantile":{"type":"number","default":0.05},"upperQuantile":{"type":"number","default":0.95}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"NORMALIZE_NUMERIC"},"column":{"type":"string"},"method":{"$ref":"#/components/schemas/NormalizeNumericMethodEnum","default":"z_score"}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"MAP_CATEGORIES"},"column":{"type":"string"},"mapping":{"type":"object","additionalProperties":{"type":"string"}},"defaultValue":{"type":["string","null"]}},"required":["type","column","mapping"]},{"type":"object","properties":{"type":{"type":"string","const":"TIME_SERIES_AGGREGATE"},"timeColumn":{"type":"string"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}},"dateFormat":{"anyOf":[{"$ref":"#/components/schemas/DatetimeFormatSchema"},{"type":"null"}]}},"required":["type","timeColumn","granularity","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"TIME_SERIES_JOIN"},"joinType":{"$ref":"#/components/schemas/JoinTypeEnum"},"leftTimeColumn":{"type":"string"},"rightTimeColumn":{"type":"string"},"rightSource":{"type":"string"},"strategy":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"granularity"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]}},"required":["type","granularity"]},{"type":"object","properties":{"type":{"type":"string","const":"asOf"},"direction":{"$ref":"#/components/schemas/AsOfDirectionEnum"},"tolerance":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"$ref":"#/components/schemas/ToleranceUnitEnum"}},"required":["value","unit"]},{"type":"null"}]}},"required":["type","direction"]},{"type":"object","properties":{"type":{"type":"string","const":"interval"},"leftEndColumn":{"type":"string"}},"required":["type","leftEndColumn"]}],"discriminator":{"propertyName":"type"}},"exactMatchKeys":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"leftField":{"type":"string"},"rightField":{"type":"string"}},"required":["leftField","rightField"]}},{"type":"null"}]},"multiMatch":{"$ref":"#/components/schemas/MultiMatchStrategyEnum"},"multiMatchAggregations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}},{"type":"null"}]}},"required":["type","joinType","leftTimeColumn","rightTimeColumn","rightSource","strategy","multiMatch"]},{"type":"object","properties":{"type":{"type":"string","const":"TRANSPOSE"},"timeColumn":{"type":"string"},"envColumns":{"type":"array","items":{"type":"string"}},"valueColumns":{"type":"array","items":{"type":"string"}},"columnTemplate":{"type":"string"},"joinStrategy":{"anyOf":[{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"granularity"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]}},"required":["type","granularity"]},{"type":"object","properties":{"type":{"type":"string","const":"asOf"},"direction":{"$ref":"#/components/schemas/AsOfDirectionEnum"},"tolerance":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"$ref":"#/components/schemas/ToleranceUnitEnum"}},"required":["value","unit"]},{"type":"null"}]}},"required":["type","direction"]}],"discriminator":{"propertyName":"type"}},{"type":"null"}]}},"required":["type","timeColumn","envColumns","valueColumns","columnTemplate"]},{"type":"object","properties":{"type":{"type":"string","const":"FREQUENCY_ANALYSIS"},"timeColumn":{"type":"string"},"valueColumns":{"type":"array","items":{"type":"string"}},"method":{"$ref":"#/components/schemas/FrequencyMethodEnum"},"windowFunction":{"$ref":"#/components/schemas/FrequencyWindowFunctionEnum","default":"hann"},"windowSize":{"type":["number","null"]},"overlap":{"type":"number","default":0.5},"samplingRateHz":{"type":["number","null"]},"outputFormat":{"$ref":"#/components/schemas/FrequencyOutputFormatEnum"},"frequencyRange":{"anyOf":[{"type":"object","properties":{"minHz":{"type":["number","null"]},"maxHz":{"type":["number","null"]}}},{"type":"null"}]},"frequencyUnit":{"$ref":"#/components/schemas/FrequencyUnitEnum","default":"hz"}},"required":["type","timeColumn","valueColumns","method","outputFormat"]},{"type":"object","properties":{"type":{"type":"string","const":"CYCLIC_AGGREGATE"},"timeColumn":{"type":"string"},"cycleComponent":{"$ref":"#/components/schemas/CyclicComponentEnum"},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}}},"required":["type","timeColumn","cycleComponent","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"DIFF"},"timeColumn":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"partitionColumns":{"type":"array","items":{"type":"string"},"default":[]},"outputSuffix":{"type":"string","default":"_diff"},"replaceColumns":{"type":"boolean","default":false}},"required":["type","timeColumn","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"DATE_DIFF"},"startColumn":{"type":"string"},"endColumn":{"type":"string"},"unit":{"$ref":"#/components/schemas/DateDiffUnitEnum","default":"days"},"sign":{"$ref":"#/components/schemas/DateDiffSignEnum","default":"signed"},"outputColumn":{"type":["string","null"]}},"required":["type","startColumn","endColumn"]},{"type":"object","properties":{"type":{"type":"string","const":"CUMULATIVE"},"timeColumn":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"partitionColumns":{"type":"array","items":{"type":"string"},"default":[]},"outputSuffix":{"type":"string","default":"_cumsum"},"replaceColumns":{"type":"boolean","default":false}},"required":["type","timeColumn","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_DECOMPOSE"},"column":{"type":"string"},"mode":{"$ref":"#/components/schemas/ArrayDecomposeModeEnum","default":"position"},"maxColumns":{"type":"integer","exclusiveMinimum":0,"default":500},"outputPrefix":{"type":"string","default":"_"}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_CONSOLIDATE"},"groups":{"type":"array","items":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"string"},"minItems":1},"outputColumn":{"type":"string"},"dropSource":{"type":"boolean","default":true},"includeNulls":{"type":"boolean","default":false}},"required":["columns","outputColumn"]},"minItems":1}},"required":["type","groups"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_EXPLODE"},"column":{"type":"string"},"outputColumn":{"type":["string","null"]},"preserveIndex":{"type":"boolean","default":false}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_AGGREGATE"},"column":{"type":"string"},"aggregation":{"$ref":"#/components/schemas/ArrayAggregationKindEnum"},"outputColumn":{"type":["string","null"]}},"required":["type","column","aggregation"]},{"type":"object","properties":{"type":{"type":"string","const":"JSON_FLATTEN"},"column":{"type":"string"},"maxColumns":{"type":"integer","exclusiveMinimum":0,"default":500},"separator":{"type":"string","default":"."},"dropSource":{"type":"boolean","default":true}},"required":["type","column"]}],"discriminator":{"propertyName":"type"}},"FilterSchema":{"type":"object","properties":{"column":{"type":"string"},"comparisonOperator":{"$ref":"#/components/schemas/ComparisonOperatorEnum"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":["string","number","boolean"]}}]},"correctType":{"type":"boolean"}},"required":["column","comparisonOperator","value","correctType"]},"ComparisonOperatorEnum":{"type":"string","enum":["Equal to","Not Equal to","Contains","Does not contain","Starts with","Ends with","Is Empty","Is not Empty","Less than","Greater than","Less than or equal to","Greater than or equal to","Before","After","Array contains","Array contains any","Array contains all","Array does not contain","Array does not contain any","Array does not contain all","Array size equal to","Array size greater than","Array size less than"]},"FilterGroupSchema":{"type":"object","properties":{"booleanOperator":{"$ref":"#/components/schemas/LogicalOperatorEnum"},"filters":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]}}},"required":["booleanOperator","filters"]},"LogicalOperatorEnum":{"type":"string","enum":["AND","OR"]},"AggregationFunctionSchema":{"type":"object","properties":{"column":{"type":"string"},"function":{"$ref":"#/components/schemas/AggregateFunctionEnum"},"alias":{"type":["string","null"]},"filter":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]},{"type":"null"}]}},"required":["column","function"]},"AggregateFunctionEnum":{"type":"string","enum":["sum","avg","min","max","count","countDistinct","first","last","categoryShare"]},"JoinTypeEnum":{"type":"string","enum":["inner","left","right","full"]},"JoinColumnPairSchema":{"type":"object","properties":{"leftField":{"type":"string"},"rightField":{"type":"string"}},"required":["leftField","rightField"]},"JoinConflictResolutionEnum":{"type":"string","enum":["keep_left","keep_right","prefix"]},"UnmatchedRuleEnum":{"type":"string","enum":["error","drop","append"]},"SortColumnSchema":{"type":"object","properties":{"column":{"type":"string"},"direction":{"$ref":"#/components/schemas/SortDirectionEnum"}},"required":["column","direction"]},"SortDirectionEnum":{"type":"string","enum":["asc","desc"]},"SplitTypeEnum":{"type":"string","enum":["delimiter","pattern"]},"NewColumnDefinitionSchema":{"type":"object","properties":{"name":{"type":"string"},"pattern":{"type":["string","null"]}},"required":["name"]},"KeepEnum":{"type":"string","enum":["first","last"]},"ImputeMethodEnum":{"type":"string","enum":["mean","median","mode","constant"]},"SchemaMainTypeEnum":{"type":"string","enum":["None","String","Category","Number","Boolean","DateTime","Array","Unknown"]},"SchemaSubTypeEnum":{"type":"string","enum":["Integer","Float","UnsignedInteger","UnsignedFloat","String","Number","Category","Boolean","DateTime"]},"InterpolateTimeMethodEnum":{"type":"string","enum":["linear","time","index"]},"NormalizeNumericMethodEnum":{"type":"string","enum":["min_max","z_score"]},"DatetimeFormatSchema":{"type":"string","minLength":1},"AsOfDirectionEnum":{"type":"string","enum":["backward","forward","nearest"]},"ToleranceUnitEnum":{"type":"string","enum":["us","ms","s","m","h","d"]},"MultiMatchStrategyEnum":{"type":"string","enum":["first","last","aggregate"]},"FrequencyMethodEnum":{"type":"string","enum":["fft","welch"]},"FrequencyWindowFunctionEnum":{"type":"string","enum":["hann","hamming","blackman","rectangular"]},"FrequencyOutputFormatEnum":{"type":"string","enum":["spectrogram","time_frequency_long"]},"FrequencyUnitEnum":{"type":"string","enum":["hz","per_minute","per_hour","per_day","per_week","per_month","per_year"]},"CyclicComponentEnum":{"type":"string","enum":["second_in_minute","minute_in_hour","hour_of_day","day_of_week","day_of_month","week_of_year","month_of_year","quarter_of_year"]},"DateDiffUnitEnum":{"type":"string","enum":["seconds","minutes","hours","days","weeks"]},"DateDiffSignEnum":{"type":"string","enum":["signed","absolute"]},"ArrayDecomposeModeEnum":{"type":"string","enum":["position","one_hot"]},"ArrayAggregationKindEnum":{"type":"string","enum":["mean","sum","min","max","median","count"]},"DataViewCreatedByEnum":{"type":"string","enum":["manual","ontology_query","ai","recommended"]},"DataViewSourceQuerySchema":{"type":"object","properties":{"queryRequest":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"reconciliationColumnSides":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ReconciliationColumnSideEnum"}},{"type":"null"}]},"reconciliationColumnGroups":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ReconciliationColumnGroupSchema"}},{"type":"null"}]},"reconciliationSecondaries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ReconciliationSecondaryMetaSchema"}},{"type":"null"}]},"reconciliationAlignKeyLabels":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"additionalProperties":true},"ReconciliationColumnSideEnum":{"type":"string","enum":["primary","secondary","system","context"]},"ReconciliationColumnGroupSchema":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"fieldIds":{"type":"array","items":{"type":"string"}}},"required":["key","label","fieldIds"]},"ReconciliationSecondaryMetaSchema":{"type":"object","properties":{"secondaryKey":{"type":"string"},"secondaryName":{"type":"string"},"presenceCol":{"type":["string","null"]},"mismatchCol":{"type":["string","null"]},"statusCol":{"type":["string","null"]}},"required":["secondaryKey","secondaryName"]},"ViewConceptOverrideEntrySchema":{"type":"object","properties":{"override":{"type":"object","additionalProperties":{}},"displayName":{"type":["string","null"]},"description":{"type":["string","null"]},"lineageHash":{"type":["string","null"]},"lastEditedBy":{"type":["string","null"]},"lastEditedAt":{"type":["string","null"]}},"required":["override"]},"BrokenDataViewDependencySchema":{"type":"object","properties":{"type":{"type":"string","enum":["DATASET","DATA_VIEW"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"]},"ReportStatusSchema":{"type":"string","enum":["draft","ready","error"]},"reportPublishSchema":{"type":"object","properties":{"slug":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"consumerAccess":{"anyOf":[{"type":"string","enum":["private","workspace","organisation","public"]},{"type":"null"}]},"resolvedInputs":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"datasetId":{"type":"string"},"versionId":{"type":["string","null"]},"deltaVersion":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["datasetId"]}},{"type":"null"}]},"widgetSnapshot":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":{}}},{"type":"null"}]},"snapshotAt":{"type":["string","null"]},"snapshotStats":{"anyOf":[{"type":"object","properties":{"requested":{"type":"number"},"resolved":{"type":"number"},"omitted":{"type":"number"},"timedOut":{"type":"boolean"},"bytes":{"type":"number"}},"required":["requested","resolved","omitted","timedOut","bytes"]},{"type":"null"}]}}}},"responses":{"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"429":{"description":"Too Many Requests; the response carries Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}}}},"paths":{"/api/v1/workspaces/{wsId}/reports/{id}":{"get":{"operationId":"get-api-v1-workspaces-{wsId}-reports-{id}","summary":"Get report","description":"Returns the report by id from platform MongoDB. Must belong to the workspace.","tags":["Reports"],"parameters":[{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportEnvelope"}}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Delete report

> Deletes the report from platform MongoDB. Requires reports:write and full permission.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Reports"}],"servers":[{"url":"https://sandbox.rootcause.ai","description":"Sandbox"},{"url":"https://platform.rootcause.ai","description":"Production"},{"url":"http://localhost:3000","description":"Local development"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one."}},"responses":{"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"429":{"description":"Too Many Requests; the response carries Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}}}},"paths":{"/api/v1/workspaces/{wsId}/reports/{id}":{"delete":{"operationId":"delete-api-v1-workspaces-{wsId}-reports-{id}","summary":"Delete report","description":"Deletes the report from platform MongoDB. Requires reports:write and full permission.","tags":["Reports"],"parameters":[{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"responses":{"204":{"description":"No Content"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Update report

> Updates title, description, and/or markdown. Only these fields are writable. updatedAt is set automatically. Widgets and evidence are typically managed by the UI or other flows.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Reports"}],"servers":[{"url":"https://sandbox.rootcause.ai","description":"Sandbox"},{"url":"https://platform.rootcause.ai","description":"Production"},{"url":"http://localhost:3000","description":"Local development"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one."}},"schemas":{"UpdateReportInput":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":["string","null"]},"markdown":{"type":"string"}}},"ReportEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Report"}},"required":["data"]},"Report":{"type":"object","properties":{"id":{"type":["string","null"]},"workspaceId":{"type":"string"},"organisationId":{"type":"string"},"title":{"type":"string"},"markdown":{"type":"string"},"widgets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"chart"},"explorerConfig":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"dataView":{"anyOf":[{"$ref":"#/components/schemas/DataViewSchema"},{"type":"null"}]},"operations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/OperationSchema"}},{"type":"null"}]},"additionalSources":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SourceSchema"}},{"type":"null"}]},"inlineData":{"anyOf":[{"type":"object","properties":{"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["None","String","Category","Number","Boolean","DateTime","Array","Unknown"]}},"required":["name","type"]},"minItems":1},"rows":{"type":"array","items":{"type":"object","additionalProperties":{"type":["string","number","boolean","null"]}},"default":[]},"downsampled":{"type":"boolean"},"totalRows":{"type":["number","null"]}},"required":["columns"]},{"type":"null"}]},"series":{"anyOf":[{"type":"object","properties":{"labels":{"type":"array","items":{"type":["string","number"]},"default":[]},"datasets":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"meta":{"anyOf":[{"type":"object","properties":{"version":{"type":"number","default":1},"xField":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"]},"default":[]},"series":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"yField":{"type":["string","null"]},"aggregation":{"type":["string","null"]}},"required":["label"]},"default":[]},"categoriesTotal":{"type":["number","null"]},"categoriesShown":{"type":["number","null"]},"otherFolded":{"type":["boolean","null"]},"sortBy":{"type":["string","null"]},"sortType":{"type":["string","null"]},"binCount":{"type":["number","null"]},"linksTotal":{"type":["number","null"]},"linksShown":{"type":["number","null"]},"pointsTotal":{"type":["number","null"]},"pointsShown":{"type":["number","null"]},"rowsScanned":{"type":["number","null"]},"rowsWithoutCategory":{"type":["number","null"]},"rowsExcluded":{"type":["number","null"]},"rowsExcludedBy":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string"},"column":{"type":["string","null"]},"rows":{"type":"number"}},"required":["reason","rows"]}},{"type":"null"}]},"downsampled":{"type":["boolean","null"]},"summary":{"type":"string","default":""}},"additionalProperties":true},{"type":"null"}]}}},{"type":"null"}]},"xSelection":{"type":"string"},"traces":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"bar"},"options":{"anyOf":[{"type":"object","properties":{"stacked":{"type":"boolean","default":false},"aggregation":{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"line"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"anyOf":[{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"},{"type":"null"}]},"tension":{"type":"number","minimum":0,"maximum":1,"default":0.4},"showPoints":{"type":"boolean","default":true}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"scatter"},"options":{"anyOf":[{"type":"object","properties":{"showLine":{"type":"boolean","default":false},"pointRadius":{"type":"number","minimum":1,"maximum":20,"default":3}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"area"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"anyOf":[{"type":"string","enum":["average","sum","count","min","max"],"default":"sum"},{"type":"null"}]},"tension":{"type":"number","minimum":0,"maximum":1,"default":0.4},"fillOpacity":{"type":"number","minimum":0,"maximum":1,"default":0.3}}},{"type":"null"}]}},"required":["id","name","ySelection","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"histogram"},"options":{"anyOf":[{"type":"object","properties":{"bins":{"type":"number","minimum":5,"maximum":100,"default":20}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"pie"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"default":"sum","type":"string","enum":["average","sum","count","min","max"]}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"default":[]},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"doughnut"},"options":{"anyOf":[{"type":"object","properties":{"aggregation":{"default":"sum","type":"string","enum":["average","sum","count","min","max"]}}},{"type":"null"}]}},"required":["id","name","chartType"]},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ySelection":{"type":"array","items":{"type":"string"},"minItems":1},"yAxisPosition":{"type":"string","enum":["left","right"],"default":"left"},"color":{"type":["string","null"]},"visible":{"type":"boolean","default":true},"chartType":{"type":"string","const":"sankey"}},"required":["id","name","ySelection","chartType"]}],"discriminator":{"propertyName":"chartType"}}},"config":{"type":"object","properties":{"responsive":{"type":"boolean","default":true},"chartTitle":{"type":["string","null"]},"dataPoints":{"type":"number","default":-1},"dataDisplayOrder":{"type":"string","enum":["fromStart","fromEnd"],"default":"fromStart"},"sortBy":{"anyOf":[{"type":"string","enum":["none","x","y"]},{"type":"null"}]},"sortType":{"anyOf":[{"type":"string","enum":["ascending","descending","natural"]},{"type":"null"}]},"advancedSettings":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}}}},"required":["id","xSelection","traces","config"]},{"type":"null"}]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"table"},"title":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","additionalProperties":{}}},"rows":{"type":"array","items":{"type":"object","additionalProperties":{}}},"totalRows":{"type":"number"},"csvExport":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"sql_evidence"},"rowCount":{"type":"integer","minimum":0},"queryTruncated":{"type":"boolean"},"queryTotalRowCount":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}},"required":["source","rowCount","queryTruncated"]},{"type":"null"}]},"livePaging":{"anyOf":[{"type":"object","properties":{"source":{"type":"string","const":"anchor_sql"},"sql":{"type":"string"},"projectionMode":{"type":"string","enum":["related","minimal"],"default":"related"}},"required":["source","sql"]},{"type":"null"}]}},"required":["id","evidenceId","type","columns","rows","totalRows"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_preview"},"datasetId":{"type":"string"}},"required":["id","evidenceId","type","datasetId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_view_preview"},"dataViewId":{"type":"string"}},"required":["id","evidenceId","type","dataViewId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"kpi_card"},"title":{"type":"string"},"value":{"type":["string","number"]},"dataBinding":{"anyOf":[{"oneOf":[{"type":"object","properties":{"sourceType":{"type":"string","const":"dataset"},"datasetId":{"type":"string","minLength":1},"valueField":{"type":"string","minLength":1}},"required":["sourceType","datasetId","valueField"]},{"type":"object","properties":{"sourceType":{"type":"string","const":"dataview"},"dataViewId":{"type":"string","minLength":1},"valueField":{"type":"string","minLength":1}},"required":["sourceType","dataViewId","valueField"]}],"discriminator":{"propertyName":"sourceType"}},{"type":"null"}]},"unit":{"type":["string","null"]},"unitId":{"type":["string","null"]},"change":{"type":["number","null"]},"changePeriod":{"type":["string","null"]},"trend":{"anyOf":[{"type":"string","enum":["up","down","neutral"]},{"type":"null"}]}},"required":["id","evidenceId","type","title","value"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_graph"},"digitalTwinVersionId":{"type":"string"}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dataset_search_results"},"searchQuery":{"type":"string"},"datasetIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","datasetIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"data_view_search_results"},"searchQuery":{"type":"string"},"dataViewIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","dataViewIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_result"},"digitalTwinRunId":{"type":"string"}},"required":["id","evidenceId","type","digitalTwinRunId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_search_results"},"digitalTwinVersionIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","digitalTwinVersionIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"digital_twin_run_search_results"},"searchQuery":{"type":"string"},"runIds":{"type":"array","items":{"type":"string"}}},"required":["id","evidenceId","type","searchQuery","runIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_graph"},"searchQuery":{"type":"string"},"conceptIds":{"type":"array","items":{"type":"string"}},"anchorType":{"type":"string","enum":["dataset","identifier","conceptType"],"default":"dataset"},"showFullGraph":{"type":"boolean","default":false}},"required":["id","evidenceId","type","searchQuery","conceptIds"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"path_analysis_sankey"},"digitalTwinVersionId":{"type":"string"},"selectedNode":{"type":["string","null"]},"selectedEdge":{"anyOf":[{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},{"type":"null"}]},"depthLimit":{"type":"number","default":2}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"parameter_distribution"},"digitalTwinVersionId":{"type":"string"},"selectedNode":{"type":["string","null"]},"selectedEdge":{"anyOf":[{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},{"type":"null"}]}},"required":["id","evidenceId","type","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_diff"},"version1Id":{"type":"string"},"version2Id":{"type":"string"}},"required":["id","evidenceId","type","version1Id","version2Id"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dose_response"},"causeVariable":{"type":"string"},"sweptMode":{"anyOf":[{"type":"string","enum":["absolute","percentage"]},{"type":"null"}]},"metric":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"causeValue":{"type":"number"},"effect":{"type":"number"},"ciLower":{"type":["number","null"]},"ciUpper":{"type":["number","null"]}},"required":["causeValue","effect"]}},"referenceValue":{"type":["number","null"]},"isLinear":{"type":["boolean","null"]},"inflectionPoints":{"anyOf":[{"type":"array","items":{"type":"number"}},{"type":"null"}]},"digitalTwinRunId":{"type":["string","null"]}},"required":["id","evidenceId","type","causeVariable","metric","points"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"page_context"},"section":{"anyOf":[{"type":"string","enum":["Organisation Home","Workspace Home","Dataset Selection","Dataset Page","Data View Selection","Data View Page","Digital Twin Selection","Digital Twin Page","Report Selection","Report Page","Settings"]},{"type":"null"}]},"summary":{"type":"string"},"entityName":{"type":["string","null"]},"entityType":{"anyOf":[{"type":"string","enum":["dataset","data_view","digital_twin","report"]},{"type":"null"}]},"itemCount":{"type":["number","null"]}},"required":["id","evidenceId","type","summary"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"dag_review"},"digitalTwinVersionId":{"type":"string"},"digitalTwinName":{"type":"string"},"nodeCount":{"type":"number"},"edgeCount":{"type":"number"},"overallHealth":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"description":{"type":"string"},"severity":{"type":"string","enum":["high","medium","low"]},"suggestedFix":{"type":["string","null"]},"affectedNodes":{"type":"array","items":{"type":"string"},"default":[]},"affectedEdges":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"}},"required":["source","target"]},"default":[]}},"required":["type","description","severity"]},"default":[]},"recommendations":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id","evidenceId","type","digitalTwinVersionId","digitalTwinName","nodeCount","edgeCount","overallHealth"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"causal_context"},"outcomeVariable":{"type":"string"},"relatedConcepts":{"type":"array","items":{"type":"object","properties":{"concept":{"type":"string"},"source":{"type":["string","null"]},"sourceName":{"type":["string","null"]},"role":{"type":["string","null"]},"isIdentifier":{"type":"boolean","default":false}},"required":["concept"]},"default":[]},"datasetSourceCount":{"type":"number","default":0},"recommendation":{"type":["string","null"]},"existingDataViewId":{"type":["string","null"]},"existingDataViewName":{"type":["string","null"]},"existingDigitalTwinId":{"type":["string","null"]},"existingDigitalTwinName":{"type":["string","null"]}},"required":["id","evidenceId","type","outcomeVariable"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"graph_query_result"},"queryType":{"type":"string"},"digitalTwinVersionId":{"type":"string"},"queriedNode":{"type":["string","null"]},"results":{"type":"array","items":{"type":"object","properties":{"node":{"type":"string"},"edgeLabel":{"type":["string","null"]},"strength":{"type":["number","null"]},"depth":{"type":["number","null"]},"type":{"type":["string","null"]}},"required":["node"]},"default":[]},"path":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}},"required":["id","evidenceId","type","queryType","digitalTwinVersionId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_data"},"columns":{"type":"array","items":{"type":"string"},"default":[]},"rowCount":{"type":"number","default":0},"sampleRows":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"dataViewId":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"ontology_mutation_preview"},"operations":{"type":"array","items":{"type":"object","additionalProperties":{}},"default":[]},"successCount":{"type":"number","default":0},"failureCount":{"type":"number","default":0},"affectedConceptIds":{"type":"array","items":{"type":"string"},"default":[]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"docs_sources"},"documentReferences":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"path":{"type":"string"},"pageId":{"type":["string","null"]}},"required":["title","path"]}}},"required":["id","evidenceId","type","documentReferences"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"background_runs"},"runs":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"entityId":{"type":["string","null"]},"status":{"type":"string"},"percentage":{"type":["number","null"]},"label":{"type":["string","null"]},"error":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["runId","name","domain","status"]}}},"required":["id","evidenceId","type","runs"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_segments"},"title":{"type":"string"},"silhouetteScore":{"type":["number","null"]},"segments":{"type":"array","items":{"type":"object","properties":{"segment":{"type":"number"},"label":{"type":"string"},"description":{"type":["string","null"]},"environments":{"type":"array","items":{"type":"string"}}},"required":["segment","label","environments"]}},"points":{"type":"array","items":{"type":"object","properties":{"envKey":{"type":"string"},"x":{"type":"number"},"y":{"type":"number"},"segment":{"type":"number"}},"required":["envKey","x","y","segment"]}}},"required":["id","evidenceId","type","title","segments","points"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_comparison"},"title":{"type":"string"},"sliceLabel":{"type":"string"},"baselineLabel":{"type":"string"},"sliceEnvCount":{"type":"number"},"baselineEnvCount":{"type":"number"},"edges":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"sliceAgreement":{"type":"number"},"baselineAgreement":{"type":"number"},"sliceStrength":{"type":["number","null"]},"baselineStrength":{"type":["number","null"]},"verdict":{"type":"string","enum":["slice-only","missing-from-slice","differs","consistent"]}},"required":["source","target","sliceAgreement","baselineAgreement","verdict"]}}},"required":["id","evidenceId","type","title","sliceLabel","baselineLabel","sliceEnvCount","baselineEnvCount","edges"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"environment_coverage"},"title":{"type":"string"},"environments":{"type":"array","items":{"type":"object","properties":{"envKey":{"type":"string"},"trainingRows":{"type":["number","null"]},"variablesTrained":{"type":["number","null"]},"variablesTotal":{"type":["number","null"]},"missing":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"reason":{"type":["string","null"]}},"required":["name"]}},"evaluation":{"type":["string","null"]}},"required":["envKey","missing"]}}},"required":["id","evidenceId","type","title","environments"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"clarification"},"toolCallId":{"type":"string"},"mode":{"type":"string","enum":["multiple_choice","form"]},"question":{"type":"string"},"why":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"preview":{"type":["string","null"]}},"required":["label","value"]},"default":[]},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"type":{"type":"string","enum":["number","string","select","multiselect","boolean","source","dataset","digitalTwin","ontologyConcept"],"default":"string"},"default":{"anyOf":[{},{"type":"null"}]},"options":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"value":{"type":"string"},"label":{"type":["string","null"]}},"required":["value"]}]}},{"type":"null"}]},"min":{"type":["number","null"]},"max":{"type":["number","null"]},"step":{"type":["number","null"]},"pattern":{"type":["string","null"]},"control":{"type":["string","null"]},"placeholder":{"type":["string","null"]},"help":{"type":["string","null"]},"required":{"type":["boolean","null"]},"secret":{"type":["boolean","null"]},"urlParam":{"type":["string","null"]}},"required":["id"]},"default":[]},"selectedValues":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"selectedFieldValues":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["id","evidenceId","type","toolCallId","mode","question"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"action_confirmation"},"toolCallId":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"severity":{"type":"string","enum":["mutates_truth","long_running","irreversible"]},"actionLabel":{"type":"string"},"estimatedDuration":{"type":["string","null"]},"changes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"before":{"type":["string","null"]},"after":{"type":["string","null"]}},"required":["label"]}},{"type":"null"}]},"details":{"type":["string","null"]},"editableKind":{"anyOf":[{"type":"string","enum":["extraction_schema"]},{"type":"null"}]},"editableInputs":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"toolName":{"type":["string","null"]},"toolInputs":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}},"required":["id","evidenceId","type","toolCallId","title","summary","severity","actionLabel"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"navigation"},"commandId":{"type":"string"},"label":{"type":"string"},"subtitle":{"type":["string","null"]},"kind":{"type":"string","enum":["navigate","create","action"],"default":"navigate"},"entity":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["dataset","dataview","concept","digitalTwin","report","digitalTwinRun"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"]},{"type":"null"}]}},"required":["id","evidenceId","type","commandId","label"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"foundational_ontology_install"},"ontologyId":{"type":"string"},"version":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"trustTier":{"type":"string"},"anchorsSummary":{"type":["string","null"]},"conceptCount":{"type":"number"},"sourceCount":{"type":"number"},"suggestedScopeNote":{"type":["string","null"]}},"required":["id","evidenceId","type","ontologyId","version","name","trustTier","conceptCount","sourceCount"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"stat_grid"},"title":{"type":["string","null"]},"stats":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"value":{"type":["string","number"]},"unit":{"type":["string","null"]},"unitId":{"type":["string","null"]},"decimals":{"type":["number","null"]},"change":{"type":["number","null"]},"changePeriod":{"type":["string","null"]},"trend":{"anyOf":[{"type":"string","enum":["up","down","neutral"]},{"type":"null"}]}},"required":["title","value"]}},"gridCols":{"anyOf":[{"type":"number","enum":[2,3,4]},{"type":"null"}]}},"required":["id","evidenceId","type","stats"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"markdown"},"content":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"heading"},"text":{"type":["string","null"]},"eyebrow":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"divider"},"style":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"image"},"src":{"type":["string","null"]},"alt":{"type":["string","null"]},"caption":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"iframe"},"url":{"type":["string","null"]}},"required":["id","evidenceId","type"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"application"},"applicationId":{"type":"string"},"runId":{"type":["string","null"]},"name":{"type":["string","null"]},"status":{"type":["string","null"]},"moduleCount":{"type":["number","null"]},"publicUrl":{"type":["string","null"]}},"required":["id","evidenceId","type","applicationId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"report"},"reportId":{"type":"string"},"title":{"type":["string","null"]},"status":{"type":["string","null"]},"rev":{"type":["number","null"]}},"required":["id","evidenceId","type","reportId"]},{"type":"object","properties":{"id":{"type":"string"},"evidenceId":{"type":"string"},"type":{"type":"string","const":"lineage"},"lineageId":{"type":"string"},"tool":{"type":"string","default":""},"hops":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","default":""}},"required":["kind","id"]},"status":{"type":"string","enum":["resolved","denied","deleted"]},"parents":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"label":{"type":"string","default":""}},"required":["kind","id"]},"default":[]},"pin":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string"},"id":{"type":"string"},"versionId":{"type":["string","null"]},"ordinal":{"type":["number","null"]},"deltaVersion":{"type":["number","null"]},"label":{"type":["string","null"]}},"required":["kind","id"]},{"type":"null"}]},"detail":{"type":"object","additionalProperties":{},"default":{}}},"required":["ref","status"]},"default":[]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":["number","null"]},"valueType":{"type":["string","null"]},"unit":{"type":["string","null"]},"display":{"type":["string","null"]}}},{"type":"null"}]},"request":{"anyOf":[{"type":"object","properties":{"sql":{"type":["string","null"]},"query":{"type":["string","null"]}}},{"type":"null"}]}},"required":["id","evidenceId","type","lineageId"]}],"discriminator":{"propertyName":"type"}}},"evidenceIds":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"status":{"$ref":"#/components/schemas/ReportStatusSchema"},"rev":{"type":"integer"},"error":{"type":["string","null"]},"prompt":{"type":["string","null"]},"publish":{"anyOf":[{"$ref":"#/components/schemas/reportPublishSchema"},{"type":"null"}]}},"required":["workspaceId","organisationId","title","markdown","widgets","evidenceIds","createdAt","updatedAt"]},"DataViewSchema":{"type":"object","properties":{"_id":{"type":"string"},"organisationId":{"type":"string"},"workspaceId":{"type":"string"},"ownerId":{"type":"string"},"name":{"type":"string"},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"rowCount":{"type":["number","null"]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceSchema"}},"operations":{"type":"array","items":{"$ref":"#/components/schemas/OperationSchema"}},"anchorConceptId":{"type":["string","null"]},"createdBy":{"anyOf":[{"$ref":"#/components/schemas/DataViewCreatedByEnum"},{"type":"null"}]},"sourceQuery":{"anyOf":[{"$ref":"#/components/schemas/DataViewSourceQuerySchema"},{"type":"null"}]},"sourceQueryDetached":{"type":["boolean","null"]},"chartWidgets":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"layout":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"required":["x","y","w","h"]},"widget":{"type":"object","additionalProperties":{}}},"required":["id","layout","widget"]}},{"type":"null"}]},"conceptOverrides":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ViewConceptOverrideEntrySchema"}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["ok","broken"]},{"type":"null"}]},"brokenReasons":{"anyOf":[{"type":"array","items":{"type":"string","enum":["source_removed","ontology_reset"]}},{"type":"null"}]},"brokenDependencies":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/BrokenDataViewDependencySchema"}},{"type":"null"}]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["_id","organisationId","workspaceId","ownerId","name","sources","operations"]},"SourceSchema":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"DATASET"},"name":{"type":["string","null"]},"conceptIds":{"type":"array","items":{"type":"string"}},"conceptVersions":{"anyOf":[{"type":"object","additionalProperties":{"type":"integer","minimum":0}},{"type":"null"}]},"version":{"anyOf":[{"$ref":"#/components/schemas/SourcePinSchema"},{"type":"null"}]}},"required":["id","type","conceptIds"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"DATA_VIEW"},"name":{"type":["string","null"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"CONCEPT"},"name":{"type":["string","null"]},"prioritiseCalculation":{"type":"boolean","default":true},"showCalculationColumns":{"type":"boolean","default":false}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","const":"GEO_SIDECAR"},"name":{"type":["string","null"]},"conceptId":{"type":"string"},"sidecarKey":{"type":"string"}},"required":["id","type","conceptId","sidecarKey"]}],"discriminator":{"propertyName":"type"}},"SourcePinSchema":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"latest"}},"required":["kind"]},{"type":"object","properties":{"kind":{"type":"string","const":"pinned"},"versionId":{"type":"string"}},"required":["kind","versionId"]}],"discriminator":{"propertyName":"kind"}},"OperationSchema":{"type":"object","properties":{"id":{"type":"string"},"sourceId":{"type":"string"},"config":{"$ref":"#/components/schemas/OperationConfigSchema"}},"required":["id","sourceId","config"]},"OperationConfigSchema":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"FILTER"},"filterGroup":{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]}},"required":["type","filterGroup"]},{"type":"object","properties":{"type":{"type":"string","const":"AGGREGATE"},"groupByColumns":{"type":"array","items":{"type":"string"}},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}}},"required":["type","groupByColumns","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"JOIN"},"joinType":{"$ref":"#/components/schemas/JoinTypeEnum"},"columnPairs":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/JoinColumnPairSchema"}},{"type":"null"}]},"leftField":{"type":["string","null"]},"rightField":{"type":["string","null"]},"conflictResolution":{"$ref":"#/components/schemas/JoinConflictResolutionEnum"},"leftPrefix":{"type":["string","null"]},"rightPrefix":{"type":["string","null"]}},"required":["type","joinType","conflictResolution"]},{"type":"object","properties":{"type":{"type":"string","const":"CONCATENATE"},"topSource":{"type":["string","null"]},"bottomSource":{"type":["string","null"]},"sources":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"columnMapping":{"type":"object","additionalProperties":{"type":"string"}},"unmatchedRule":{"$ref":"#/components/schemas/UnmatchedRuleEnum"},"discriminatorColumn":{"type":["string","null"]},"discriminatorValues":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["type","columnMapping","unmatchedRule"]},{"type":"object","properties":{"type":{"type":"string","const":"SORT"},"sortColumns":{"type":"array","items":{"$ref":"#/components/schemas/SortColumnSchema"}}},"required":["type","sortColumns"]},{"type":"object","properties":{"type":{"type":"string","const":"SQL_QUERY"},"query":{"type":"string"},"columnSourceAliases":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"required":["type","query"]},{"type":"object","properties":{"type":{"type":"string","const":"SPLIT_COLUMN"},"columnToSplit":{"type":"string"},"splitType":{"$ref":"#/components/schemas/SplitTypeEnum"},"delimiter":{"type":["string","null"]},"columns":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/NewColumnDefinitionSchema"}},{"type":"null"}]}},"required":["type","columnToSplit","splitType"]},{"type":"object","properties":{"type":{"type":"string","const":"DROP_COLUMNS"},"columns":{"type":"array","items":{"type":"string"}}},"required":["type","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"REMOVE_DUPLICATES"},"column":{"type":["string","null"]},"keep":{"$ref":"#/components/schemas/KeepEnum","default":"first"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"IMPUTE_NULLS"},"method":{"$ref":"#/components/schemas/ImputeMethodEnum","default":"constant"},"column":{"type":["string","null"]},"fillValue":{"anyOf":[{"type":["string","number","boolean"]},{"type":"null"}]},"imputations":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"method":{"$ref":"#/components/schemas/ImputeMethodEnum","default":"constant"},"fillValue":{"anyOf":[{"type":["string","number","boolean"]},{"type":"null"}]}},"required":["column"]}},{"type":"null"}]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"DROP_NULLS"},"axis":{"type":"string","enum":["rows","empty_columns"],"default":"rows"},"column":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"string"},"default":[]},"nullThresholdPercent":{"type":"number","default":100}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"REPLACE_VALUES"},"column":{"type":"string"},"mapping":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["type","column","mapping"]},{"type":"object","properties":{"type":{"type":"string","const":"REPLACE_TYPE"},"changes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"column":{"type":"string"},"toType":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"toSubType":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"dateFormat":{"type":["string","null"]}},"required":["column","toType"]}},{"type":"null"}]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"INTERPOLATE_TIME"},"column":{"type":"string"},"frequency":{"type":"string"},"method":{"$ref":"#/components/schemas/InterpolateTimeMethodEnum"}},"required":["type","column","frequency","method"]},{"type":"object","properties":{"type":{"type":"string","const":"CLIP_OUTLIERS"},"column":{"type":"string"},"lowerQuantile":{"type":"number","default":0.05},"upperQuantile":{"type":"number","default":0.95}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"NORMALIZE_NUMERIC"},"column":{"type":"string"},"method":{"$ref":"#/components/schemas/NormalizeNumericMethodEnum","default":"z_score"}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"MAP_CATEGORIES"},"column":{"type":"string"},"mapping":{"type":"object","additionalProperties":{"type":"string"}},"defaultValue":{"type":["string","null"]}},"required":["type","column","mapping"]},{"type":"object","properties":{"type":{"type":"string","const":"TIME_SERIES_AGGREGATE"},"timeColumn":{"type":"string"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}},"dateFormat":{"anyOf":[{"$ref":"#/components/schemas/DatetimeFormatSchema"},{"type":"null"}]}},"required":["type","timeColumn","granularity","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"TIME_SERIES_JOIN"},"joinType":{"$ref":"#/components/schemas/JoinTypeEnum"},"leftTimeColumn":{"type":"string"},"rightTimeColumn":{"type":"string"},"rightSource":{"type":"string"},"strategy":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"granularity"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]}},"required":["type","granularity"]},{"type":"object","properties":{"type":{"type":"string","const":"asOf"},"direction":{"$ref":"#/components/schemas/AsOfDirectionEnum"},"tolerance":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"$ref":"#/components/schemas/ToleranceUnitEnum"}},"required":["value","unit"]},{"type":"null"}]}},"required":["type","direction"]},{"type":"object","properties":{"type":{"type":"string","const":"interval"},"leftEndColumn":{"type":"string"}},"required":["type","leftEndColumn"]}],"discriminator":{"propertyName":"type"}},"exactMatchKeys":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"leftField":{"type":"string"},"rightField":{"type":"string"}},"required":["leftField","rightField"]}},{"type":"null"}]},"multiMatch":{"$ref":"#/components/schemas/MultiMatchStrategyEnum"},"multiMatchAggregations":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}},{"type":"null"}]}},"required":["type","joinType","leftTimeColumn","rightTimeColumn","rightSource","strategy","multiMatch"]},{"type":"object","properties":{"type":{"type":"string","const":"TRANSPOSE"},"timeColumn":{"type":"string"},"envColumns":{"type":"array","items":{"type":"string"}},"valueColumns":{"type":"array","items":{"type":"string"}},"columnTemplate":{"type":"string"},"joinStrategy":{"anyOf":[{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"granularity"},"granularity":{"type":"string","enum":["nanosecond","microsecond","millisecond","second","minute","hour","day","week","month","quarter","year"]}},"required":["type","granularity"]},{"type":"object","properties":{"type":{"type":"string","const":"asOf"},"direction":{"$ref":"#/components/schemas/AsOfDirectionEnum"},"tolerance":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"$ref":"#/components/schemas/ToleranceUnitEnum"}},"required":["value","unit"]},{"type":"null"}]}},"required":["type","direction"]}],"discriminator":{"propertyName":"type"}},{"type":"null"}]}},"required":["type","timeColumn","envColumns","valueColumns","columnTemplate"]},{"type":"object","properties":{"type":{"type":"string","const":"FREQUENCY_ANALYSIS"},"timeColumn":{"type":"string"},"valueColumns":{"type":"array","items":{"type":"string"}},"method":{"$ref":"#/components/schemas/FrequencyMethodEnum"},"windowFunction":{"$ref":"#/components/schemas/FrequencyWindowFunctionEnum","default":"hann"},"windowSize":{"type":["number","null"]},"overlap":{"type":"number","default":0.5},"samplingRateHz":{"type":["number","null"]},"outputFormat":{"$ref":"#/components/schemas/FrequencyOutputFormatEnum"},"frequencyRange":{"anyOf":[{"type":"object","properties":{"minHz":{"type":["number","null"]},"maxHz":{"type":["number","null"]}}},{"type":"null"}]},"frequencyUnit":{"$ref":"#/components/schemas/FrequencyUnitEnum","default":"hz"}},"required":["type","timeColumn","valueColumns","method","outputFormat"]},{"type":"object","properties":{"type":{"type":"string","const":"CYCLIC_AGGREGATE"},"timeColumn":{"type":"string"},"cycleComponent":{"$ref":"#/components/schemas/CyclicComponentEnum"},"aggregations":{"type":"array","items":{"$ref":"#/components/schemas/AggregationFunctionSchema"}}},"required":["type","timeColumn","cycleComponent","aggregations"]},{"type":"object","properties":{"type":{"type":"string","const":"DIFF"},"timeColumn":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"partitionColumns":{"type":"array","items":{"type":"string"},"default":[]},"outputSuffix":{"type":"string","default":"_diff"},"replaceColumns":{"type":"boolean","default":false}},"required":["type","timeColumn","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"DATE_DIFF"},"startColumn":{"type":"string"},"endColumn":{"type":"string"},"unit":{"$ref":"#/components/schemas/DateDiffUnitEnum","default":"days"},"sign":{"$ref":"#/components/schemas/DateDiffSignEnum","default":"signed"},"outputColumn":{"type":["string","null"]}},"required":["type","startColumn","endColumn"]},{"type":"object","properties":{"type":{"type":"string","const":"CUMULATIVE"},"timeColumn":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"partitionColumns":{"type":"array","items":{"type":"string"},"default":[]},"outputSuffix":{"type":"string","default":"_cumsum"},"replaceColumns":{"type":"boolean","default":false}},"required":["type","timeColumn","columns"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_DECOMPOSE"},"column":{"type":"string"},"mode":{"$ref":"#/components/schemas/ArrayDecomposeModeEnum","default":"position"},"maxColumns":{"type":"integer","exclusiveMinimum":0,"default":500},"outputPrefix":{"type":"string","default":"_"}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_CONSOLIDATE"},"groups":{"type":"array","items":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"string"},"minItems":1},"outputColumn":{"type":"string"},"dropSource":{"type":"boolean","default":true},"includeNulls":{"type":"boolean","default":false}},"required":["columns","outputColumn"]},"minItems":1}},"required":["type","groups"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_EXPLODE"},"column":{"type":"string"},"outputColumn":{"type":["string","null"]},"preserveIndex":{"type":"boolean","default":false}},"required":["type","column"]},{"type":"object","properties":{"type":{"type":"string","const":"ARRAY_AGGREGATE"},"column":{"type":"string"},"aggregation":{"$ref":"#/components/schemas/ArrayAggregationKindEnum"},"outputColumn":{"type":["string","null"]}},"required":["type","column","aggregation"]},{"type":"object","properties":{"type":{"type":"string","const":"JSON_FLATTEN"},"column":{"type":"string"},"maxColumns":{"type":"integer","exclusiveMinimum":0,"default":500},"separator":{"type":"string","default":"."},"dropSource":{"type":"boolean","default":true}},"required":["type","column"]}],"discriminator":{"propertyName":"type"}},"FilterSchema":{"type":"object","properties":{"column":{"type":"string"},"comparisonOperator":{"$ref":"#/components/schemas/ComparisonOperatorEnum"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":["string","number","boolean"]}}]},"correctType":{"type":"boolean"}},"required":["column","comparisonOperator","value","correctType"]},"ComparisonOperatorEnum":{"type":"string","enum":["Equal to","Not Equal to","Contains","Does not contain","Starts with","Ends with","Is Empty","Is not Empty","Less than","Greater than","Less than or equal to","Greater than or equal to","Before","After","Array contains","Array contains any","Array contains all","Array does not contain","Array does not contain any","Array does not contain all","Array size equal to","Array size greater than","Array size less than"]},"FilterGroupSchema":{"type":"object","properties":{"booleanOperator":{"$ref":"#/components/schemas/LogicalOperatorEnum"},"filters":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]}}},"required":["booleanOperator","filters"]},"LogicalOperatorEnum":{"type":"string","enum":["AND","OR"]},"AggregationFunctionSchema":{"type":"object","properties":{"column":{"type":"string"},"function":{"$ref":"#/components/schemas/AggregateFunctionEnum"},"alias":{"type":["string","null"]},"filter":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/FilterSchema"},{"$ref":"#/components/schemas/FilterGroupSchema"}]},{"type":"null"}]}},"required":["column","function"]},"AggregateFunctionEnum":{"type":"string","enum":["sum","avg","min","max","count","countDistinct","first","last","categoryShare"]},"JoinTypeEnum":{"type":"string","enum":["inner","left","right","full"]},"JoinColumnPairSchema":{"type":"object","properties":{"leftField":{"type":"string"},"rightField":{"type":"string"}},"required":["leftField","rightField"]},"JoinConflictResolutionEnum":{"type":"string","enum":["keep_left","keep_right","prefix"]},"UnmatchedRuleEnum":{"type":"string","enum":["error","drop","append"]},"SortColumnSchema":{"type":"object","properties":{"column":{"type":"string"},"direction":{"$ref":"#/components/schemas/SortDirectionEnum"}},"required":["column","direction"]},"SortDirectionEnum":{"type":"string","enum":["asc","desc"]},"SplitTypeEnum":{"type":"string","enum":["delimiter","pattern"]},"NewColumnDefinitionSchema":{"type":"object","properties":{"name":{"type":"string"},"pattern":{"type":["string","null"]}},"required":["name"]},"KeepEnum":{"type":"string","enum":["first","last"]},"ImputeMethodEnum":{"type":"string","enum":["mean","median","mode","constant"]},"SchemaMainTypeEnum":{"type":"string","enum":["None","String","Category","Number","Boolean","DateTime","Array","Unknown"]},"SchemaSubTypeEnum":{"type":"string","enum":["Integer","Float","UnsignedInteger","UnsignedFloat","String","Number","Category","Boolean","DateTime"]},"InterpolateTimeMethodEnum":{"type":"string","enum":["linear","time","index"]},"NormalizeNumericMethodEnum":{"type":"string","enum":["min_max","z_score"]},"DatetimeFormatSchema":{"type":"string","minLength":1},"AsOfDirectionEnum":{"type":"string","enum":["backward","forward","nearest"]},"ToleranceUnitEnum":{"type":"string","enum":["us","ms","s","m","h","d"]},"MultiMatchStrategyEnum":{"type":"string","enum":["first","last","aggregate"]},"FrequencyMethodEnum":{"type":"string","enum":["fft","welch"]},"FrequencyWindowFunctionEnum":{"type":"string","enum":["hann","hamming","blackman","rectangular"]},"FrequencyOutputFormatEnum":{"type":"string","enum":["spectrogram","time_frequency_long"]},"FrequencyUnitEnum":{"type":"string","enum":["hz","per_minute","per_hour","per_day","per_week","per_month","per_year"]},"CyclicComponentEnum":{"type":"string","enum":["second_in_minute","minute_in_hour","hour_of_day","day_of_week","day_of_month","week_of_year","month_of_year","quarter_of_year"]},"DateDiffUnitEnum":{"type":"string","enum":["seconds","minutes","hours","days","weeks"]},"DateDiffSignEnum":{"type":"string","enum":["signed","absolute"]},"ArrayDecomposeModeEnum":{"type":"string","enum":["position","one_hot"]},"ArrayAggregationKindEnum":{"type":"string","enum":["mean","sum","min","max","median","count"]},"DataViewCreatedByEnum":{"type":"string","enum":["manual","ontology_query","ai","recommended"]},"DataViewSourceQuerySchema":{"type":"object","properties":{"queryRequest":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"reconciliationColumnSides":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ReconciliationColumnSideEnum"}},{"type":"null"}]},"reconciliationColumnGroups":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ReconciliationColumnGroupSchema"}},{"type":"null"}]},"reconciliationSecondaries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ReconciliationSecondaryMetaSchema"}},{"type":"null"}]},"reconciliationAlignKeyLabels":{"anyOf":[{"type":"object","additionalProperties":{"type":"string"}},{"type":"null"}]}},"additionalProperties":true},"ReconciliationColumnSideEnum":{"type":"string","enum":["primary","secondary","system","context"]},"ReconciliationColumnGroupSchema":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"fieldIds":{"type":"array","items":{"type":"string"}}},"required":["key","label","fieldIds"]},"ReconciliationSecondaryMetaSchema":{"type":"object","properties":{"secondaryKey":{"type":"string"},"secondaryName":{"type":"string"},"presenceCol":{"type":["string","null"]},"mismatchCol":{"type":["string","null"]},"statusCol":{"type":["string","null"]}},"required":["secondaryKey","secondaryName"]},"ViewConceptOverrideEntrySchema":{"type":"object","properties":{"override":{"type":"object","additionalProperties":{}},"displayName":{"type":["string","null"]},"description":{"type":["string","null"]},"lineageHash":{"type":["string","null"]},"lastEditedBy":{"type":["string","null"]},"lastEditedAt":{"type":["string","null"]}},"required":["override"]},"BrokenDataViewDependencySchema":{"type":"object","properties":{"type":{"type":"string","enum":["DATASET","DATA_VIEW"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"]},"ReportStatusSchema":{"type":"string","enum":["draft","ready","error"]},"reportPublishSchema":{"type":"object","properties":{"slug":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"consumerAccess":{"anyOf":[{"type":"string","enum":["private","workspace","organisation","public"]},{"type":"null"}]},"resolvedInputs":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"datasetId":{"type":"string"},"versionId":{"type":["string","null"]},"deltaVersion":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["datasetId"]}},{"type":"null"}]},"widgetSnapshot":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":{}}},{"type":"null"}]},"snapshotAt":{"type":["string","null"]},"snapshotStats":{"anyOf":[{"type":"object","properties":{"requested":{"type":"number"},"resolved":{"type":"number"},"omitted":{"type":"number"},"timedOut":{"type":"boolean"},"bytes":{"type":"number"}},"required":["requested","resolved","omitted","timedOut","bytes"]},{"type":"null"}]}}}},"responses":{"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"429":{"description":"Too Many Requests; the response carries Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}}}},"paths":{"/api/v1/workspaces/{wsId}/reports/{id}":{"patch":{"operationId":"patch-api-v1-workspaces-{wsId}-reports-{id}","summary":"Update report","description":"Updates title, description, and/or markdown. Only these fields are writable. updatedAt is set automatically. Widgets and evidence are typically managed by the UI or other flows.","tags":["Reports"],"parameters":[{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: id"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateReportInput"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportEnvelope"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```
