> 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/sources.md).

# Sources

## List organisation sources

> Lists sources across the whole organisation, including ones not linked into any workspace. Sources are org-owned; a workspace sees one only through a link, so this is where to look when a workspace appears to have no data. Query params: limit, cursor, parentId (folder id, or 'all' to flatten the tree), format, search, sortBy, sortDir. Reads platform MongoDB.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"SourceListEnvelope":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"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"]},"Source":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":["string","null"]},"organisationId":{"type":"string"},"name":{"type":"string"},"parentSourceId":{"type":["string","null"]},"dataSource":{"anyOf":[{"$ref":"#/components/schemas/DataSourceTypeEnum"},{"type":"null"}]},"dataFormat":{"$ref":"#/components/schemas/datasetFormatsEnum"},"description":{"type":["string","null"]},"maintainedBy":{"type":"array","items":{"type":"object","properties":{"applicationId":{"type":"string"},"version":{"type":"string"},"flowId":{"type":"string"}},"required":["applicationId","version","flowId"]}},"richDescription":{"anyOf":[{"$ref":"#/components/schemas/RichDescriptionSchema"},{"type":"null"}]},"schemaEntries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaEntryModelSchema"}},{"type":"null"}]},"importWarnings":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ontologyMode":{"$ref":"#/components/schemas/OntologyModeEnum","default":"auto"},"documentCount":{"type":["number","null"]},"columnMetadata":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ColumnMetadataSchema"}},{"type":"null"}]},"extension":{"type":["string","null"]},"totalSize":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"lastSaved":{"type":["string","null"]},"virtual":{"type":["boolean","null"]},"ontologyStatus":{"anyOf":[{"$ref":"#/components/schemas/OntologyStatusEnum"},{"type":"null"}]},"ontologyError":{"type":["string","null"]},"extractionStatus":{"anyOf":[{"$ref":"#/components/schemas/ExtractionStatusEnum"},{"type":"null"}]},"extractionError":{"type":["string","null"]},"pageCount":{"type":["number","null"]},"derivedFromDatasetIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"derivedVia":{"anyOf":[{"$ref":"#/components/schemas/DerivedViaEnum"},{"type":"null"}]},"extractionRecipe":{"anyOf":[{"$ref":"#/components/schemas/ExtractionRecipeSchema"},{"type":"null"}]},"pendingAnnotationCount":{"type":["number","null"]},"ontologyExcludedFields":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"},"source":{"type":"string","enum":["auto","user","suggestion"]}},"required":["field","reason","source"]}},{"type":"null"}]},"batchRanges":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string"},"fileName":{"type":"string"},"uploadedAt":{"type":"string"},"rowStart":{"type":"number"},"rowEnd":{"type":"number"}},"required":["hash","fileName","uploadedAt","rowStart","rowEnd"]}},{"type":"null"}]},"currentVersionId":{"type":["string","null"]},"latestVersionOrdinal":{"type":["number","null"]},"staging":{"type":["boolean","null"]},"readMode":{"type":"string","enum":["direct_query","snapshot"],"description":"How this source is read. direct_query runs every read against the origin database — live, but subject to its statement timeout, and no row count is recorded; snapshot reads a stored copy, which changes only when it is synced"},"directQuery":{"anyOf":[{"$ref":"#/components/schemas/directQuerySettingsSchema"},{"type":"null"}],"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"required":["id","organisationId","name","dataFormat","readMode","directQuery"]},"DataSourceTypeEnum":{"type":"string","enum":["Local Upload","API Upload","Web Research","Document Extraction","Workbook Extraction","PostgreSQL","MySQL","ClickHouse","MongoDB","REST API","Snowflake","S3","Azure Data Lake","Google Cloud Storage","Google Drive","Redshift","BigQuery","Databricks","Azure Synapse","Salesforce","Hubspot","NetSuite","Kafka"]},"datasetFormatsEnum":{"type":"string","enum":["Folder","Tabular","Text","Workbook","PDF","DOCX","PPTX","Image","Audio","Video"]},"RichDescriptionSchema":{"type":"object","properties":{"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"}}}},"required":["markdown","widgets"]},"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"]},"SchemaEntryModelSchema":{"type":"object","properties":{"field":{"type":"string"},"type":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"subtype":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"availableTypes":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaMainTypeEnum"}},{"type":"null"}]},"isIndex":{"type":["boolean","null"]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"aliases":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"displayWidth":{"type":["number","null"]},"originalFormat":{"type":["string","null"]},"displayFormat":{"type":["string","null"]},"unit":{"type":["string","null"]},"unitModifier":{"type":["number","null"]},"dateOrderAssumed":{"type":["boolean","null"]}},"required":["field","type"]},"OntologyModeEnum":{"type":"string","enum":["auto","manual"]},"ColumnMetadataSchema":{"type":"object","properties":{"dtype":{"type":["string","null"]},"categoryOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"distribution":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"rangeFrom":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"rangeTo":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"mean":{"type":["number","null"]},"stringPattern":{"type":["string","null"]},"jsonObjectFraction":{"type":["number","null"]},"cardinality":{"type":["number","null"]},"nullFraction":{"type":["number","null"]},"unparsedFormat":{"type":["string","null"]},"processing":{"type":["boolean","null"]},"metadataStatus":{"anyOf":[{"$ref":"#/components/schemas/MetadataStatusEnum"},{"type":"null"}]},"elementType":{"anyOf":[{"$ref":"#/components/schemas/SchemaMainTypeEnum"},{"type":"null"}]},"minSize":{"type":["number","null"]},"maxSize":{"type":["number","null"]},"avgSize":{"type":["number","null"]},"medianSize":{"type":["number","null"]},"p95Size":{"type":["number","null"]},"nullCount":{"type":["number","null"]},"emptyCount":{"type":["number","null"]},"totalElementCount":{"type":["number","null"]},"sizeDistribution":{"anyOf":[{"$ref":"#/components/schemas/ArraySizeDistributionSchema"},{"type":"null"}]},"uniqueElementCount":{"type":["number","null"]},"avgUniquePerRow":{"type":["number","null"]},"elementOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"elementMin":{"type":["number","null"]},"elementMax":{"type":["number","null"]},"elementMean":{"type":["number","null"]},"elementSum":{"type":["number","null"]},"elementStddev":{"type":["number","null"]}}},"MetadataStatusEnum":{"type":"string","enum":["complete","partial_skipped_expensive","in_progress"]},"ArraySizeDistributionSchema":{"type":"object","properties":{"empty":{"type":"number","default":0},"oneToThree":{"type":"number","default":0},"fourToTen":{"type":"number","default":0},"elevenToFifty":{"type":"number","default":0},"fiftyPlus":{"type":"number","default":0}}},"OntologyStatusEnum":{"type":"string","enum":["pending","extracting","consolidation_queued","consolidating","detecting_derived","analyzing_dependencies","profiling_time_series","completed","extraction_failed","consolidation_failed","derived_detection_failed","relationship_detection_failed","cross_relationship_detection_failed","dependency_analysis_failed","time_series_profiling_failed","cancelled","manual_pending"]},"ExtractionStatusEnum":{"type":"string","enum":["pending","extracting","completed","failed"]},"DerivedViaEnum":{"type":"string","enum":["document_tables","document_homogenisation","document_entities","workbook_sql"]},"ExtractionRecipeSchema":{"type":"object","properties":{"mode":{"type":"string","enum":["schema","entities"]},"sourceDocumentIds":{"type":"array","items":{"type":"string"}},"columns":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"entityTypes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true},"default":[]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"targetName":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastAppendedAt":{"type":["string","null"]}},"required":["mode","sourceDocumentIds"],"additionalProperties":true},"directQuerySettingsSchema":{"type":"object","properties":{"orderingColumn":{"type":["string","null"],"description":"Column the source's rows are paged by"},"appendOnly":{"type":["boolean","null"],"description":"Declared: the rows are only ever added, never updated or deleted"},"statementTimeoutSeconds":{"type":["number","null"],"description":"Cap on how long one remote statement may run"},"maxRowsScanned":{"type":["number","null"],"description":"Cap on how many rows one remote statement may scan"}},"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"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/sources":{"get":{"operationId":"get-api-v1-sources","summary":"List organisation sources","description":"Lists sources across the whole organisation, including ones not linked into any workspace. Sources are org-owned; a workspace sees one only through a link, so this is where to look when a workspace appears to have no data. Query params: limit, cursor, parentId (folder id, or 'all' to flatten the tree), format, search, sortBy, sortDir. Reads platform MongoDB.","tags":["Sources"],"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`."},{"in":"query","name":"parentId","required":false,"schema":{"type":"string","description":"Only return sources derived from this source."},"description":"Only return sources derived from this source."},{"in":"query","name":"format","required":false,"schema":{"type":"string","description":"Filter by data format."},"description":"Filter by data format."},{"in":"query","name":"search","required":false,"schema":{"type":"string","description":"Case-insensitive filter on source name."},"description":"Case-insensitive filter on source name."},{"in":"query","name":"sortBy","required":false,"schema":{"type":"string","description":"Field to sort by (default createdAt)."},"description":"Field to sort by (default createdAt)."},{"in":"query","name":"sortDir","required":false,"schema":{"type":"string","enum":["asc","desc"],"description":"Sort direction (default desc)."},"description":"Sort direction (default desc)."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceListEnvelope"}}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Get organisation source

> Returns one org-level source, plus linkedWorkspaceIds — the workspaces it is currently linked into. Must belong to the caller's organisation and pass the caller's sources-area access check.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"OrgSourceEnvelope":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":["string","null"]},"organisationId":{"type":"string"},"name":{"type":"string"},"parentSourceId":{"type":["string","null"]},"dataSource":{"anyOf":[{"$ref":"#/components/schemas/DataSourceTypeEnum"},{"type":"null"}]},"dataFormat":{"$ref":"#/components/schemas/datasetFormatsEnum"},"description":{"type":["string","null"]},"maintainedBy":{"type":"array","items":{"type":"object","properties":{"applicationId":{"type":"string"},"version":{"type":"string"},"flowId":{"type":"string"}},"required":["applicationId","version","flowId"]}},"richDescription":{"anyOf":[{"$ref":"#/components/schemas/RichDescriptionSchema"},{"type":"null"}]},"schemaEntries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaEntryModelSchema"}},{"type":"null"}]},"importWarnings":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ontologyMode":{"$ref":"#/components/schemas/OntologyModeEnum","default":"auto"},"documentCount":{"type":["number","null"]},"columnMetadata":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ColumnMetadataSchema"}},{"type":"null"}]},"extension":{"type":["string","null"]},"totalSize":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"lastSaved":{"type":["string","null"]},"virtual":{"type":["boolean","null"]},"ontologyStatus":{"anyOf":[{"$ref":"#/components/schemas/OntologyStatusEnum"},{"type":"null"}]},"ontologyError":{"type":["string","null"]},"extractionStatus":{"anyOf":[{"$ref":"#/components/schemas/ExtractionStatusEnum"},{"type":"null"}]},"extractionError":{"type":["string","null"]},"pageCount":{"type":["number","null"]},"derivedFromDatasetIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"derivedVia":{"anyOf":[{"$ref":"#/components/schemas/DerivedViaEnum"},{"type":"null"}]},"extractionRecipe":{"anyOf":[{"$ref":"#/components/schemas/ExtractionRecipeSchema"},{"type":"null"}]},"pendingAnnotationCount":{"type":["number","null"]},"ontologyExcludedFields":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"},"source":{"type":"string","enum":["auto","user","suggestion"]}},"required":["field","reason","source"]}},{"type":"null"}]},"batchRanges":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string"},"fileName":{"type":"string"},"uploadedAt":{"type":"string"},"rowStart":{"type":"number"},"rowEnd":{"type":"number"}},"required":["hash","fileName","uploadedAt","rowStart","rowEnd"]}},{"type":"null"}]},"currentVersionId":{"type":["string","null"]},"latestVersionOrdinal":{"type":["number","null"]},"staging":{"type":["boolean","null"]},"readMode":{"type":"string","enum":["direct_query","snapshot"],"description":"How this source is read. direct_query runs every read against the origin database — live, but subject to its statement timeout, and no row count is recorded; snapshot reads a stored copy, which changes only when it is synced"},"directQuery":{"anyOf":[{"$ref":"#/components/schemas/directQuerySettingsSchema"},{"type":"null"}],"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"},"linkedWorkspaceIds":{"type":"array","items":{"type":"string"},"description":"Workspaces this source is linked into"}},"required":["id","organisationId","name","dataFormat","readMode","directQuery","linkedWorkspaceIds"]}},"required":["data"]},"DataSourceTypeEnum":{"type":"string","enum":["Local Upload","API Upload","Web Research","Document Extraction","Workbook Extraction","PostgreSQL","MySQL","ClickHouse","MongoDB","REST API","Snowflake","S3","Azure Data Lake","Google Cloud Storage","Google Drive","Redshift","BigQuery","Databricks","Azure Synapse","Salesforce","Hubspot","NetSuite","Kafka"]},"datasetFormatsEnum":{"type":"string","enum":["Folder","Tabular","Text","Workbook","PDF","DOCX","PPTX","Image","Audio","Video"]},"RichDescriptionSchema":{"type":"object","properties":{"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"}}}},"required":["markdown","widgets"]},"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"]},"SchemaEntryModelSchema":{"type":"object","properties":{"field":{"type":"string"},"type":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"subtype":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"availableTypes":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaMainTypeEnum"}},{"type":"null"}]},"isIndex":{"type":["boolean","null"]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"aliases":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"displayWidth":{"type":["number","null"]},"originalFormat":{"type":["string","null"]},"displayFormat":{"type":["string","null"]},"unit":{"type":["string","null"]},"unitModifier":{"type":["number","null"]},"dateOrderAssumed":{"type":["boolean","null"]}},"required":["field","type"]},"OntologyModeEnum":{"type":"string","enum":["auto","manual"]},"ColumnMetadataSchema":{"type":"object","properties":{"dtype":{"type":["string","null"]},"categoryOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"distribution":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"rangeFrom":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"rangeTo":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"mean":{"type":["number","null"]},"stringPattern":{"type":["string","null"]},"jsonObjectFraction":{"type":["number","null"]},"cardinality":{"type":["number","null"]},"nullFraction":{"type":["number","null"]},"unparsedFormat":{"type":["string","null"]},"processing":{"type":["boolean","null"]},"metadataStatus":{"anyOf":[{"$ref":"#/components/schemas/MetadataStatusEnum"},{"type":"null"}]},"elementType":{"anyOf":[{"$ref":"#/components/schemas/SchemaMainTypeEnum"},{"type":"null"}]},"minSize":{"type":["number","null"]},"maxSize":{"type":["number","null"]},"avgSize":{"type":["number","null"]},"medianSize":{"type":["number","null"]},"p95Size":{"type":["number","null"]},"nullCount":{"type":["number","null"]},"emptyCount":{"type":["number","null"]},"totalElementCount":{"type":["number","null"]},"sizeDistribution":{"anyOf":[{"$ref":"#/components/schemas/ArraySizeDistributionSchema"},{"type":"null"}]},"uniqueElementCount":{"type":["number","null"]},"avgUniquePerRow":{"type":["number","null"]},"elementOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"elementMin":{"type":["number","null"]},"elementMax":{"type":["number","null"]},"elementMean":{"type":["number","null"]},"elementSum":{"type":["number","null"]},"elementStddev":{"type":["number","null"]}}},"MetadataStatusEnum":{"type":"string","enum":["complete","partial_skipped_expensive","in_progress"]},"ArraySizeDistributionSchema":{"type":"object","properties":{"empty":{"type":"number","default":0},"oneToThree":{"type":"number","default":0},"fourToTen":{"type":"number","default":0},"elevenToFifty":{"type":"number","default":0},"fiftyPlus":{"type":"number","default":0}}},"OntologyStatusEnum":{"type":"string","enum":["pending","extracting","consolidation_queued","consolidating","detecting_derived","analyzing_dependencies","profiling_time_series","completed","extraction_failed","consolidation_failed","derived_detection_failed","relationship_detection_failed","cross_relationship_detection_failed","dependency_analysis_failed","time_series_profiling_failed","cancelled","manual_pending"]},"ExtractionStatusEnum":{"type":"string","enum":["pending","extracting","completed","failed"]},"DerivedViaEnum":{"type":"string","enum":["document_tables","document_homogenisation","document_entities","workbook_sql"]},"ExtractionRecipeSchema":{"type":"object","properties":{"mode":{"type":"string","enum":["schema","entities"]},"sourceDocumentIds":{"type":"array","items":{"type":"string"}},"columns":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"entityTypes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true},"default":[]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"targetName":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastAppendedAt":{"type":["string","null"]}},"required":["mode","sourceDocumentIds"],"additionalProperties":true},"directQuerySettingsSchema":{"type":"object","properties":{"orderingColumn":{"type":["string","null"],"description":"Column the source's rows are paged by"},"appendOnly":{"type":["boolean","null"],"description":"Declared: the rows are only ever added, never updated or deleted"},"statementTimeoutSeconds":{"type":["number","null"],"description":"Cap on how long one remote statement may run"},"maxRowsScanned":{"type":["number","null"],"description":"Cap on how many rows one remote statement may scan"}},"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"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/sources/{id}":{"get":{"operationId":"get-api-v1-sources-{id}","summary":"Get organisation source","description":"Returns one org-level source, plus linkedWorkspaceIds — the workspaces it is currently linked into. Must belong to the caller's organisation and pass the caller's sources-area access check.","tags":["Sources"],"parameters":[{"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/OrgSourceEnvelope"}}}},"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"}}}}}}
```

## List sources

> Lists sources in the workspace. Query params: limit, cursor (for pagination), parentId (filter by parent folder), format (Tabular or Folder). Excludes virtual sources. Results from platform MongoDB.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"SourceListEnvelope":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"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"]},"Source":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":["string","null"]},"organisationId":{"type":"string"},"name":{"type":"string"},"parentSourceId":{"type":["string","null"]},"dataSource":{"anyOf":[{"$ref":"#/components/schemas/DataSourceTypeEnum"},{"type":"null"}]},"dataFormat":{"$ref":"#/components/schemas/datasetFormatsEnum"},"description":{"type":["string","null"]},"maintainedBy":{"type":"array","items":{"type":"object","properties":{"applicationId":{"type":"string"},"version":{"type":"string"},"flowId":{"type":"string"}},"required":["applicationId","version","flowId"]}},"richDescription":{"anyOf":[{"$ref":"#/components/schemas/RichDescriptionSchema"},{"type":"null"}]},"schemaEntries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaEntryModelSchema"}},{"type":"null"}]},"importWarnings":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ontologyMode":{"$ref":"#/components/schemas/OntologyModeEnum","default":"auto"},"documentCount":{"type":["number","null"]},"columnMetadata":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ColumnMetadataSchema"}},{"type":"null"}]},"extension":{"type":["string","null"]},"totalSize":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"lastSaved":{"type":["string","null"]},"virtual":{"type":["boolean","null"]},"ontologyStatus":{"anyOf":[{"$ref":"#/components/schemas/OntologyStatusEnum"},{"type":"null"}]},"ontologyError":{"type":["string","null"]},"extractionStatus":{"anyOf":[{"$ref":"#/components/schemas/ExtractionStatusEnum"},{"type":"null"}]},"extractionError":{"type":["string","null"]},"pageCount":{"type":["number","null"]},"derivedFromDatasetIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"derivedVia":{"anyOf":[{"$ref":"#/components/schemas/DerivedViaEnum"},{"type":"null"}]},"extractionRecipe":{"anyOf":[{"$ref":"#/components/schemas/ExtractionRecipeSchema"},{"type":"null"}]},"pendingAnnotationCount":{"type":["number","null"]},"ontologyExcludedFields":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"},"source":{"type":"string","enum":["auto","user","suggestion"]}},"required":["field","reason","source"]}},{"type":"null"}]},"batchRanges":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string"},"fileName":{"type":"string"},"uploadedAt":{"type":"string"},"rowStart":{"type":"number"},"rowEnd":{"type":"number"}},"required":["hash","fileName","uploadedAt","rowStart","rowEnd"]}},{"type":"null"}]},"currentVersionId":{"type":["string","null"]},"latestVersionOrdinal":{"type":["number","null"]},"staging":{"type":["boolean","null"]},"readMode":{"type":"string","enum":["direct_query","snapshot"],"description":"How this source is read. direct_query runs every read against the origin database — live, but subject to its statement timeout, and no row count is recorded; snapshot reads a stored copy, which changes only when it is synced"},"directQuery":{"anyOf":[{"$ref":"#/components/schemas/directQuerySettingsSchema"},{"type":"null"}],"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"required":["id","organisationId","name","dataFormat","readMode","directQuery"]},"DataSourceTypeEnum":{"type":"string","enum":["Local Upload","API Upload","Web Research","Document Extraction","Workbook Extraction","PostgreSQL","MySQL","ClickHouse","MongoDB","REST API","Snowflake","S3","Azure Data Lake","Google Cloud Storage","Google Drive","Redshift","BigQuery","Databricks","Azure Synapse","Salesforce","Hubspot","NetSuite","Kafka"]},"datasetFormatsEnum":{"type":"string","enum":["Folder","Tabular","Text","Workbook","PDF","DOCX","PPTX","Image","Audio","Video"]},"RichDescriptionSchema":{"type":"object","properties":{"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"}}}},"required":["markdown","widgets"]},"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"]},"SchemaEntryModelSchema":{"type":"object","properties":{"field":{"type":"string"},"type":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"subtype":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"availableTypes":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaMainTypeEnum"}},{"type":"null"}]},"isIndex":{"type":["boolean","null"]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"aliases":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"displayWidth":{"type":["number","null"]},"originalFormat":{"type":["string","null"]},"displayFormat":{"type":["string","null"]},"unit":{"type":["string","null"]},"unitModifier":{"type":["number","null"]},"dateOrderAssumed":{"type":["boolean","null"]}},"required":["field","type"]},"OntologyModeEnum":{"type":"string","enum":["auto","manual"]},"ColumnMetadataSchema":{"type":"object","properties":{"dtype":{"type":["string","null"]},"categoryOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"distribution":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"rangeFrom":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"rangeTo":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"mean":{"type":["number","null"]},"stringPattern":{"type":["string","null"]},"jsonObjectFraction":{"type":["number","null"]},"cardinality":{"type":["number","null"]},"nullFraction":{"type":["number","null"]},"unparsedFormat":{"type":["string","null"]},"processing":{"type":["boolean","null"]},"metadataStatus":{"anyOf":[{"$ref":"#/components/schemas/MetadataStatusEnum"},{"type":"null"}]},"elementType":{"anyOf":[{"$ref":"#/components/schemas/SchemaMainTypeEnum"},{"type":"null"}]},"minSize":{"type":["number","null"]},"maxSize":{"type":["number","null"]},"avgSize":{"type":["number","null"]},"medianSize":{"type":["number","null"]},"p95Size":{"type":["number","null"]},"nullCount":{"type":["number","null"]},"emptyCount":{"type":["number","null"]},"totalElementCount":{"type":["number","null"]},"sizeDistribution":{"anyOf":[{"$ref":"#/components/schemas/ArraySizeDistributionSchema"},{"type":"null"}]},"uniqueElementCount":{"type":["number","null"]},"avgUniquePerRow":{"type":["number","null"]},"elementOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"elementMin":{"type":["number","null"]},"elementMax":{"type":["number","null"]},"elementMean":{"type":["number","null"]},"elementSum":{"type":["number","null"]},"elementStddev":{"type":["number","null"]}}},"MetadataStatusEnum":{"type":"string","enum":["complete","partial_skipped_expensive","in_progress"]},"ArraySizeDistributionSchema":{"type":"object","properties":{"empty":{"type":"number","default":0},"oneToThree":{"type":"number","default":0},"fourToTen":{"type":"number","default":0},"elevenToFifty":{"type":"number","default":0},"fiftyPlus":{"type":"number","default":0}}},"OntologyStatusEnum":{"type":"string","enum":["pending","extracting","consolidation_queued","consolidating","detecting_derived","analyzing_dependencies","profiling_time_series","completed","extraction_failed","consolidation_failed","derived_detection_failed","relationship_detection_failed","cross_relationship_detection_failed","dependency_analysis_failed","time_series_profiling_failed","cancelled","manual_pending"]},"ExtractionStatusEnum":{"type":"string","enum":["pending","extracting","completed","failed"]},"DerivedViaEnum":{"type":"string","enum":["document_tables","document_homogenisation","document_entities","workbook_sql"]},"ExtractionRecipeSchema":{"type":"object","properties":{"mode":{"type":"string","enum":["schema","entities"]},"sourceDocumentIds":{"type":"array","items":{"type":"string"}},"columns":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"entityTypes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true},"default":[]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"targetName":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastAppendedAt":{"type":["string","null"]}},"required":["mode","sourceDocumentIds"],"additionalProperties":true},"directQuerySettingsSchema":{"type":"object","properties":{"orderingColumn":{"type":["string","null"],"description":"Column the source's rows are paged by"},"appendOnly":{"type":["boolean","null"],"description":"Declared: the rows are only ever added, never updated or deleted"},"statementTimeoutSeconds":{"type":["number","null"],"description":"Cap on how long one remote statement may run"},"maxRowsScanned":{"type":["number","null"],"description":"Cap on how many rows one remote statement may scan"}},"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"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}/sources":{"get":{"operationId":"get-api-v1-workspaces-{wsId}-sources","summary":"List sources","description":"Lists sources in the workspace. Query params: limit, cursor (for pagination), parentId (filter by parent folder), format (Tabular or Folder). Excludes virtual sources. Results from platform MongoDB.","tags":["Sources"],"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`."},{"in":"query","name":"parentId","required":false,"schema":{"type":"string","description":"Only return sources derived from this source."},"description":"Only return sources derived from this source."},{"in":"query","name":"format","required":false,"schema":{"type":"string","enum":["Tabular","Folder"],"description":"Filter by data format."},"description":"Filter by data format."},{"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/SourceListEnvelope"}}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Create source

> Creates an empty source (metadata only). Body: name, dataFormat (default Tabular), optional description, parentSourceId. No data is written; use upload, from-data, or connector import to add data. The source record is created in platform MongoDB; data-service is not called until first upload.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"CreateSourceSchema":{"type":"object","properties":{"name":{"type":"string"},"dataFormat":{"type":"string","enum":["Tabular","Folder","Text","PDF","Image","Audio","Video"],"default":"Tabular"},"description":{"type":["string","null"]},"parentSourceId":{"type":["string","null"]}},"required":["name","dataFormat"]},"SourceEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Source"}},"required":["data"]},"Source":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":["string","null"]},"organisationId":{"type":"string"},"name":{"type":"string"},"parentSourceId":{"type":["string","null"]},"dataSource":{"anyOf":[{"$ref":"#/components/schemas/DataSourceTypeEnum"},{"type":"null"}]},"dataFormat":{"$ref":"#/components/schemas/datasetFormatsEnum"},"description":{"type":["string","null"]},"maintainedBy":{"type":"array","items":{"type":"object","properties":{"applicationId":{"type":"string"},"version":{"type":"string"},"flowId":{"type":"string"}},"required":["applicationId","version","flowId"]}},"richDescription":{"anyOf":[{"$ref":"#/components/schemas/RichDescriptionSchema"},{"type":"null"}]},"schemaEntries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaEntryModelSchema"}},{"type":"null"}]},"importWarnings":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ontologyMode":{"$ref":"#/components/schemas/OntologyModeEnum","default":"auto"},"documentCount":{"type":["number","null"]},"columnMetadata":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ColumnMetadataSchema"}},{"type":"null"}]},"extension":{"type":["string","null"]},"totalSize":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"lastSaved":{"type":["string","null"]},"virtual":{"type":["boolean","null"]},"ontologyStatus":{"anyOf":[{"$ref":"#/components/schemas/OntologyStatusEnum"},{"type":"null"}]},"ontologyError":{"type":["string","null"]},"extractionStatus":{"anyOf":[{"$ref":"#/components/schemas/ExtractionStatusEnum"},{"type":"null"}]},"extractionError":{"type":["string","null"]},"pageCount":{"type":["number","null"]},"derivedFromDatasetIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"derivedVia":{"anyOf":[{"$ref":"#/components/schemas/DerivedViaEnum"},{"type":"null"}]},"extractionRecipe":{"anyOf":[{"$ref":"#/components/schemas/ExtractionRecipeSchema"},{"type":"null"}]},"pendingAnnotationCount":{"type":["number","null"]},"ontologyExcludedFields":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"},"source":{"type":"string","enum":["auto","user","suggestion"]}},"required":["field","reason","source"]}},{"type":"null"}]},"batchRanges":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string"},"fileName":{"type":"string"},"uploadedAt":{"type":"string"},"rowStart":{"type":"number"},"rowEnd":{"type":"number"}},"required":["hash","fileName","uploadedAt","rowStart","rowEnd"]}},{"type":"null"}]},"currentVersionId":{"type":["string","null"]},"latestVersionOrdinal":{"type":["number","null"]},"staging":{"type":["boolean","null"]},"readMode":{"type":"string","enum":["direct_query","snapshot"],"description":"How this source is read. direct_query runs every read against the origin database — live, but subject to its statement timeout, and no row count is recorded; snapshot reads a stored copy, which changes only when it is synced"},"directQuery":{"anyOf":[{"$ref":"#/components/schemas/directQuerySettingsSchema"},{"type":"null"}],"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"required":["id","organisationId","name","dataFormat","readMode","directQuery"]},"DataSourceTypeEnum":{"type":"string","enum":["Local Upload","API Upload","Web Research","Document Extraction","Workbook Extraction","PostgreSQL","MySQL","ClickHouse","MongoDB","REST API","Snowflake","S3","Azure Data Lake","Google Cloud Storage","Google Drive","Redshift","BigQuery","Databricks","Azure Synapse","Salesforce","Hubspot","NetSuite","Kafka"]},"datasetFormatsEnum":{"type":"string","enum":["Folder","Tabular","Text","Workbook","PDF","DOCX","PPTX","Image","Audio","Video"]},"RichDescriptionSchema":{"type":"object","properties":{"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"}}}},"required":["markdown","widgets"]},"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"]},"SchemaEntryModelSchema":{"type":"object","properties":{"field":{"type":"string"},"type":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"subtype":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"availableTypes":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaMainTypeEnum"}},{"type":"null"}]},"isIndex":{"type":["boolean","null"]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"aliases":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"displayWidth":{"type":["number","null"]},"originalFormat":{"type":["string","null"]},"displayFormat":{"type":["string","null"]},"unit":{"type":["string","null"]},"unitModifier":{"type":["number","null"]},"dateOrderAssumed":{"type":["boolean","null"]}},"required":["field","type"]},"OntologyModeEnum":{"type":"string","enum":["auto","manual"]},"ColumnMetadataSchema":{"type":"object","properties":{"dtype":{"type":["string","null"]},"categoryOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"distribution":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"rangeFrom":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"rangeTo":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"mean":{"type":["number","null"]},"stringPattern":{"type":["string","null"]},"jsonObjectFraction":{"type":["number","null"]},"cardinality":{"type":["number","null"]},"nullFraction":{"type":["number","null"]},"unparsedFormat":{"type":["string","null"]},"processing":{"type":["boolean","null"]},"metadataStatus":{"anyOf":[{"$ref":"#/components/schemas/MetadataStatusEnum"},{"type":"null"}]},"elementType":{"anyOf":[{"$ref":"#/components/schemas/SchemaMainTypeEnum"},{"type":"null"}]},"minSize":{"type":["number","null"]},"maxSize":{"type":["number","null"]},"avgSize":{"type":["number","null"]},"medianSize":{"type":["number","null"]},"p95Size":{"type":["number","null"]},"nullCount":{"type":["number","null"]},"emptyCount":{"type":["number","null"]},"totalElementCount":{"type":["number","null"]},"sizeDistribution":{"anyOf":[{"$ref":"#/components/schemas/ArraySizeDistributionSchema"},{"type":"null"}]},"uniqueElementCount":{"type":["number","null"]},"avgUniquePerRow":{"type":["number","null"]},"elementOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"elementMin":{"type":["number","null"]},"elementMax":{"type":["number","null"]},"elementMean":{"type":["number","null"]},"elementSum":{"type":["number","null"]},"elementStddev":{"type":["number","null"]}}},"MetadataStatusEnum":{"type":"string","enum":["complete","partial_skipped_expensive","in_progress"]},"ArraySizeDistributionSchema":{"type":"object","properties":{"empty":{"type":"number","default":0},"oneToThree":{"type":"number","default":0},"fourToTen":{"type":"number","default":0},"elevenToFifty":{"type":"number","default":0},"fiftyPlus":{"type":"number","default":0}}},"OntologyStatusEnum":{"type":"string","enum":["pending","extracting","consolidation_queued","consolidating","detecting_derived","analyzing_dependencies","profiling_time_series","completed","extraction_failed","consolidation_failed","derived_detection_failed","relationship_detection_failed","cross_relationship_detection_failed","dependency_analysis_failed","time_series_profiling_failed","cancelled","manual_pending"]},"ExtractionStatusEnum":{"type":"string","enum":["pending","extracting","completed","failed"]},"DerivedViaEnum":{"type":"string","enum":["document_tables","document_homogenisation","document_entities","workbook_sql"]},"ExtractionRecipeSchema":{"type":"object","properties":{"mode":{"type":"string","enum":["schema","entities"]},"sourceDocumentIds":{"type":"array","items":{"type":"string"}},"columns":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"entityTypes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true},"default":[]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"targetName":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastAppendedAt":{"type":["string","null"]}},"required":["mode","sourceDocumentIds"],"additionalProperties":true},"directQuerySettingsSchema":{"type":"object","properties":{"orderingColumn":{"type":["string","null"],"description":"Column the source's rows are paged by"},"appendOnly":{"type":["boolean","null"],"description":"Declared: the rows are only ever added, never updated or deleted"},"statementTimeoutSeconds":{"type":["number","null"],"description":"Cap on how long one remote statement may run"},"maxRowsScanned":{"type":["number","null"],"description":"Cap on how many rows one remote statement may scan"}},"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"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}/sources":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources","summary":"Create source","description":"Creates an empty source (metadata only). Body: name, dataFormat (default Tabular), optional description, parentSourceId. No data is written; use upload, from-data, or connector import to add data. The source record is created in platform MongoDB; data-service is not called until first upload.","tags":["Sources"],"parameters":[{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSourceSchema"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceEnvelope"}}}},"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 source

> Returns the source by id from platform MongoDB. Must belong to the workspace. Includes schemaEntries, columnMetadata, documentCount, totalSize if populated by upload or from-data.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"SourceEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Source"}},"required":["data"]},"Source":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":["string","null"]},"organisationId":{"type":"string"},"name":{"type":"string"},"parentSourceId":{"type":["string","null"]},"dataSource":{"anyOf":[{"$ref":"#/components/schemas/DataSourceTypeEnum"},{"type":"null"}]},"dataFormat":{"$ref":"#/components/schemas/datasetFormatsEnum"},"description":{"type":["string","null"]},"maintainedBy":{"type":"array","items":{"type":"object","properties":{"applicationId":{"type":"string"},"version":{"type":"string"},"flowId":{"type":"string"}},"required":["applicationId","version","flowId"]}},"richDescription":{"anyOf":[{"$ref":"#/components/schemas/RichDescriptionSchema"},{"type":"null"}]},"schemaEntries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaEntryModelSchema"}},{"type":"null"}]},"importWarnings":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ontologyMode":{"$ref":"#/components/schemas/OntologyModeEnum","default":"auto"},"documentCount":{"type":["number","null"]},"columnMetadata":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ColumnMetadataSchema"}},{"type":"null"}]},"extension":{"type":["string","null"]},"totalSize":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"lastSaved":{"type":["string","null"]},"virtual":{"type":["boolean","null"]},"ontologyStatus":{"anyOf":[{"$ref":"#/components/schemas/OntologyStatusEnum"},{"type":"null"}]},"ontologyError":{"type":["string","null"]},"extractionStatus":{"anyOf":[{"$ref":"#/components/schemas/ExtractionStatusEnum"},{"type":"null"}]},"extractionError":{"type":["string","null"]},"pageCount":{"type":["number","null"]},"derivedFromDatasetIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"derivedVia":{"anyOf":[{"$ref":"#/components/schemas/DerivedViaEnum"},{"type":"null"}]},"extractionRecipe":{"anyOf":[{"$ref":"#/components/schemas/ExtractionRecipeSchema"},{"type":"null"}]},"pendingAnnotationCount":{"type":["number","null"]},"ontologyExcludedFields":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"},"source":{"type":"string","enum":["auto","user","suggestion"]}},"required":["field","reason","source"]}},{"type":"null"}]},"batchRanges":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string"},"fileName":{"type":"string"},"uploadedAt":{"type":"string"},"rowStart":{"type":"number"},"rowEnd":{"type":"number"}},"required":["hash","fileName","uploadedAt","rowStart","rowEnd"]}},{"type":"null"}]},"currentVersionId":{"type":["string","null"]},"latestVersionOrdinal":{"type":["number","null"]},"staging":{"type":["boolean","null"]},"readMode":{"type":"string","enum":["direct_query","snapshot"],"description":"How this source is read. direct_query runs every read against the origin database — live, but subject to its statement timeout, and no row count is recorded; snapshot reads a stored copy, which changes only when it is synced"},"directQuery":{"anyOf":[{"$ref":"#/components/schemas/directQuerySettingsSchema"},{"type":"null"}],"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"required":["id","organisationId","name","dataFormat","readMode","directQuery"]},"DataSourceTypeEnum":{"type":"string","enum":["Local Upload","API Upload","Web Research","Document Extraction","Workbook Extraction","PostgreSQL","MySQL","ClickHouse","MongoDB","REST API","Snowflake","S3","Azure Data Lake","Google Cloud Storage","Google Drive","Redshift","BigQuery","Databricks","Azure Synapse","Salesforce","Hubspot","NetSuite","Kafka"]},"datasetFormatsEnum":{"type":"string","enum":["Folder","Tabular","Text","Workbook","PDF","DOCX","PPTX","Image","Audio","Video"]},"RichDescriptionSchema":{"type":"object","properties":{"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"}}}},"required":["markdown","widgets"]},"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"]},"SchemaEntryModelSchema":{"type":"object","properties":{"field":{"type":"string"},"type":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"subtype":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"availableTypes":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaMainTypeEnum"}},{"type":"null"}]},"isIndex":{"type":["boolean","null"]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"aliases":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"displayWidth":{"type":["number","null"]},"originalFormat":{"type":["string","null"]},"displayFormat":{"type":["string","null"]},"unit":{"type":["string","null"]},"unitModifier":{"type":["number","null"]},"dateOrderAssumed":{"type":["boolean","null"]}},"required":["field","type"]},"OntologyModeEnum":{"type":"string","enum":["auto","manual"]},"ColumnMetadataSchema":{"type":"object","properties":{"dtype":{"type":["string","null"]},"categoryOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"distribution":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"rangeFrom":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"rangeTo":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"mean":{"type":["number","null"]},"stringPattern":{"type":["string","null"]},"jsonObjectFraction":{"type":["number","null"]},"cardinality":{"type":["number","null"]},"nullFraction":{"type":["number","null"]},"unparsedFormat":{"type":["string","null"]},"processing":{"type":["boolean","null"]},"metadataStatus":{"anyOf":[{"$ref":"#/components/schemas/MetadataStatusEnum"},{"type":"null"}]},"elementType":{"anyOf":[{"$ref":"#/components/schemas/SchemaMainTypeEnum"},{"type":"null"}]},"minSize":{"type":["number","null"]},"maxSize":{"type":["number","null"]},"avgSize":{"type":["number","null"]},"medianSize":{"type":["number","null"]},"p95Size":{"type":["number","null"]},"nullCount":{"type":["number","null"]},"emptyCount":{"type":["number","null"]},"totalElementCount":{"type":["number","null"]},"sizeDistribution":{"anyOf":[{"$ref":"#/components/schemas/ArraySizeDistributionSchema"},{"type":"null"}]},"uniqueElementCount":{"type":["number","null"]},"avgUniquePerRow":{"type":["number","null"]},"elementOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"elementMin":{"type":["number","null"]},"elementMax":{"type":["number","null"]},"elementMean":{"type":["number","null"]},"elementSum":{"type":["number","null"]},"elementStddev":{"type":["number","null"]}}},"MetadataStatusEnum":{"type":"string","enum":["complete","partial_skipped_expensive","in_progress"]},"ArraySizeDistributionSchema":{"type":"object","properties":{"empty":{"type":"number","default":0},"oneToThree":{"type":"number","default":0},"fourToTen":{"type":"number","default":0},"elevenToFifty":{"type":"number","default":0},"fiftyPlus":{"type":"number","default":0}}},"OntologyStatusEnum":{"type":"string","enum":["pending","extracting","consolidation_queued","consolidating","detecting_derived","analyzing_dependencies","profiling_time_series","completed","extraction_failed","consolidation_failed","derived_detection_failed","relationship_detection_failed","cross_relationship_detection_failed","dependency_analysis_failed","time_series_profiling_failed","cancelled","manual_pending"]},"ExtractionStatusEnum":{"type":"string","enum":["pending","extracting","completed","failed"]},"DerivedViaEnum":{"type":"string","enum":["document_tables","document_homogenisation","document_entities","workbook_sql"]},"ExtractionRecipeSchema":{"type":"object","properties":{"mode":{"type":"string","enum":["schema","entities"]},"sourceDocumentIds":{"type":"array","items":{"type":"string"}},"columns":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"entityTypes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true},"default":[]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"targetName":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastAppendedAt":{"type":["string","null"]}},"required":["mode","sourceDocumentIds"],"additionalProperties":true},"directQuerySettingsSchema":{"type":"object","properties":{"orderingColumn":{"type":["string","null"],"description":"Column the source's rows are paged by"},"appendOnly":{"type":["boolean","null"],"description":"Declared: the rows are only ever added, never updated or deleted"},"statementTimeoutSeconds":{"type":["number","null"],"description":"Cap on how long one remote statement may run"},"maxRowsScanned":{"type":["number","null"],"description":"Cap on how many rows one remote statement may scan"}},"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"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}/sources/{id}":{"get":{"operationId":"get-api-v1-workspaces-{wsId}-sources-{id}","summary":"Get source","description":"Returns the source by id from platform MongoDB. Must belong to the workspace. Includes schemaEntries, columnMetadata, documentCount, totalSize if populated by upload or from-data.","tags":["Sources"],"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/SourceEnvelope"}}}},"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 source

> Deletes the source, every source derived from it, and the data-service state behind them; data views referencing them keep their ids and are flagged broken. Requires \`full\` access to every source in that tree, not just the one named. Refused with 409 while a digital twin was trained on any of them — \`blockingDigitalTwins\` names the twins in this workspace, and twins in workspaces the credential cannot reach are counted in \`detail\` rather than named — and refused while any source in the tree is shared into other workspaces, since deleting it removes it from those too (\`sharedSources\`, \`otherWorkspaceLinks\`). \`force=true\` overrides both refusals, but never the access check.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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"]}}}}},"schemas":{"SourceDeleteConflictProblem":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"number","const":409},"detail":{"type":"string"},"instance":{"type":"string"},"blockingDigitalTwins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"description":"The digital twins in this workspace trained on the source or on anything derived from it. Twins in workspaces this credential cannot reach are counted in `detail` rather than listed here."},"sharedSources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"description":"The sources in the deletion tree that are shared into other workspaces. Present when that is what blocks the delete."},"otherWorkspaceLinks":{"type":"number","description":"How many links into other workspaces those sources hold between them."}},"required":["type","title","status","detail","blockingDigitalTwins"]}}},"paths":{"/api/v1/workspaces/{wsId}/sources/{id}":{"delete":{"operationId":"delete-api-v1-workspaces-{wsId}-sources-{id}","summary":"Delete source","description":"Deletes the source, every source derived from it, and the data-service state behind them; data views referencing them keep their ids and are flagged broken. Requires `full` access to every source in that tree, not just the one named. Refused with 409 while a digital twin was trained on any of them — `blockingDigitalTwins` names the twins in this workspace, and twins in workspaces the credential cannot reach are counted in `detail` rather than named — and refused while any source in the tree is shared into other workspaces, since deleting it removes it from those too (`sharedSources`, `otherWorkspaceLinks`). `force=true` overrides both refusals, but never the access check.","tags":["Sources"],"parameters":[{"in":"query","name":"force","required":false,"schema":{"type":"string","enum":["true","false"],"description":"Delete even when digital twins were trained on this source. Without it such a delete is refused with 409."},"description":"Delete even when digital twins were trained on this source. Without it such a delete is refused with 409."},{"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"},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceDeleteConflictProblem"}}}},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Update source

> Updates source name and/or description only. Schema and data are not changed here.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"UpdateSourceSchema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]}},"additionalProperties":false},"SourceEnvelope":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Source"}},"required":["data"]},"Source":{"type":"object","properties":{"id":{"type":"string"},"workspaceId":{"type":["string","null"]},"organisationId":{"type":"string"},"name":{"type":"string"},"parentSourceId":{"type":["string","null"]},"dataSource":{"anyOf":[{"$ref":"#/components/schemas/DataSourceTypeEnum"},{"type":"null"}]},"dataFormat":{"$ref":"#/components/schemas/datasetFormatsEnum"},"description":{"type":["string","null"]},"maintainedBy":{"type":"array","items":{"type":"object","properties":{"applicationId":{"type":"string"},"version":{"type":"string"},"flowId":{"type":"string"}},"required":["applicationId","version","flowId"]}},"richDescription":{"anyOf":[{"$ref":"#/components/schemas/RichDescriptionSchema"},{"type":"null"}]},"schemaEntries":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaEntryModelSchema"}},{"type":"null"}]},"importWarnings":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ontologyMode":{"$ref":"#/components/schemas/OntologyModeEnum","default":"auto"},"documentCount":{"type":["number","null"]},"columnMetadata":{"anyOf":[{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ColumnMetadataSchema"}},{"type":"null"}]},"extension":{"type":["string","null"]},"totalSize":{"type":["number","null"]},"createdAt":{"type":["string","null"]},"lastSaved":{"type":["string","null"]},"virtual":{"type":["boolean","null"]},"ontologyStatus":{"anyOf":[{"$ref":"#/components/schemas/OntologyStatusEnum"},{"type":"null"}]},"ontologyError":{"type":["string","null"]},"extractionStatus":{"anyOf":[{"$ref":"#/components/schemas/ExtractionStatusEnum"},{"type":"null"}]},"extractionError":{"type":["string","null"]},"pageCount":{"type":["number","null"]},"derivedFromDatasetIds":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"derivedVia":{"anyOf":[{"$ref":"#/components/schemas/DerivedViaEnum"},{"type":"null"}]},"extractionRecipe":{"anyOf":[{"$ref":"#/components/schemas/ExtractionRecipeSchema"},{"type":"null"}]},"pendingAnnotationCount":{"type":["number","null"]},"ontologyExcludedFields":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"},"source":{"type":"string","enum":["auto","user","suggestion"]}},"required":["field","reason","source"]}},{"type":"null"}]},"batchRanges":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"hash":{"type":"string"},"fileName":{"type":"string"},"uploadedAt":{"type":"string"},"rowStart":{"type":"number"},"rowEnd":{"type":"number"}},"required":["hash","fileName","uploadedAt","rowStart","rowEnd"]}},{"type":"null"}]},"currentVersionId":{"type":["string","null"]},"latestVersionOrdinal":{"type":["number","null"]},"staging":{"type":["boolean","null"]},"readMode":{"type":"string","enum":["direct_query","snapshot"],"description":"How this source is read. direct_query runs every read against the origin database — live, but subject to its statement timeout, and no row count is recorded; snapshot reads a stored copy, which changes only when it is synced"},"directQuery":{"anyOf":[{"$ref":"#/components/schemas/directQuerySettingsSchema"},{"type":"null"}],"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"required":["id","organisationId","name","dataFormat","readMode","directQuery"]},"DataSourceTypeEnum":{"type":"string","enum":["Local Upload","API Upload","Web Research","Document Extraction","Workbook Extraction","PostgreSQL","MySQL","ClickHouse","MongoDB","REST API","Snowflake","S3","Azure Data Lake","Google Cloud Storage","Google Drive","Redshift","BigQuery","Databricks","Azure Synapse","Salesforce","Hubspot","NetSuite","Kafka"]},"datasetFormatsEnum":{"type":"string","enum":["Folder","Tabular","Text","Workbook","PDF","DOCX","PPTX","Image","Audio","Video"]},"RichDescriptionSchema":{"type":"object","properties":{"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"}}}},"required":["markdown","widgets"]},"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"]},"SchemaEntryModelSchema":{"type":"object","properties":{"field":{"type":"string"},"type":{"$ref":"#/components/schemas/SchemaMainTypeEnum"},"subtype":{"anyOf":[{"$ref":"#/components/schemas/SchemaSubTypeEnum"},{"type":"null"}]},"availableTypes":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SchemaMainTypeEnum"}},{"type":"null"}]},"isIndex":{"type":["boolean","null"]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"aliases":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"type":["string","null"]},"displayWidth":{"type":["number","null"]},"originalFormat":{"type":["string","null"]},"displayFormat":{"type":["string","null"]},"unit":{"type":["string","null"]},"unitModifier":{"type":["number","null"]},"dateOrderAssumed":{"type":["boolean","null"]}},"required":["field","type"]},"OntologyModeEnum":{"type":"string","enum":["auto","manual"]},"ColumnMetadataSchema":{"type":"object","properties":{"dtype":{"type":["string","null"]},"categoryOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"distribution":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"rangeFrom":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"rangeTo":{"anyOf":[{"type":["string","number"]},{"type":"null"}]},"mean":{"type":["number","null"]},"stringPattern":{"type":["string","null"]},"jsonObjectFraction":{"type":["number","null"]},"cardinality":{"type":["number","null"]},"nullFraction":{"type":["number","null"]},"unparsedFormat":{"type":["string","null"]},"processing":{"type":["boolean","null"]},"metadataStatus":{"anyOf":[{"$ref":"#/components/schemas/MetadataStatusEnum"},{"type":"null"}]},"elementType":{"anyOf":[{"$ref":"#/components/schemas/SchemaMainTypeEnum"},{"type":"null"}]},"minSize":{"type":["number","null"]},"maxSize":{"type":["number","null"]},"avgSize":{"type":["number","null"]},"medianSize":{"type":["number","null"]},"p95Size":{"type":["number","null"]},"nullCount":{"type":["number","null"]},"emptyCount":{"type":["number","null"]},"totalElementCount":{"type":["number","null"]},"sizeDistribution":{"anyOf":[{"$ref":"#/components/schemas/ArraySizeDistributionSchema"},{"type":"null"}]},"uniqueElementCount":{"type":["number","null"]},"avgUniquePerRow":{"type":["number","null"]},"elementOccurences":{"anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"elementMin":{"type":["number","null"]},"elementMax":{"type":["number","null"]},"elementMean":{"type":["number","null"]},"elementSum":{"type":["number","null"]},"elementStddev":{"type":["number","null"]}}},"MetadataStatusEnum":{"type":"string","enum":["complete","partial_skipped_expensive","in_progress"]},"ArraySizeDistributionSchema":{"type":"object","properties":{"empty":{"type":"number","default":0},"oneToThree":{"type":"number","default":0},"fourToTen":{"type":"number","default":0},"elevenToFifty":{"type":"number","default":0},"fiftyPlus":{"type":"number","default":0}}},"OntologyStatusEnum":{"type":"string","enum":["pending","extracting","consolidation_queued","consolidating","detecting_derived","analyzing_dependencies","profiling_time_series","completed","extraction_failed","consolidation_failed","derived_detection_failed","relationship_detection_failed","cross_relationship_detection_failed","dependency_analysis_failed","time_series_profiling_failed","cancelled","manual_pending"]},"ExtractionStatusEnum":{"type":"string","enum":["pending","extracting","completed","failed"]},"DerivedViaEnum":{"type":"string","enum":["document_tables","document_homogenisation","document_entities","workbook_sql"]},"ExtractionRecipeSchema":{"type":"object","properties":{"mode":{"type":"string","enum":["schema","entities"]},"sourceDocumentIds":{"type":"array","items":{"type":"string"}},"columns":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"entityTypes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"dtype":{"anyOf":[{"type":"string","enum":["number","category","boolean","text"]},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"trueSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"falseSynonyms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"unit":{"type":["string","null"]},"conceptId":{"type":["string","null"]}},"required":["name"],"additionalProperties":true},"default":[]}},"required":["name"],"additionalProperties":true}},{"type":"null"}]},"targetName":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastAppendedAt":{"type":["string","null"]}},"required":["mode","sourceDocumentIds"],"additionalProperties":true},"directQuerySettingsSchema":{"type":"object","properties":{"orderingColumn":{"type":["string","null"],"description":"Column the source's rows are paged by"},"appendOnly":{"type":["boolean","null"],"description":"Declared: the rows are only ever added, never updated or deleted"},"statementTimeoutSeconds":{"type":["number","null"],"description":"Cap on how long one remote statement may run"},"maxRowsScanned":{"type":["number","null"],"description":"Cap on how many rows one remote statement may scan"}},"description":"How a direct_query source is read. Null on a snapshot source, where none of it applies. The relation itself is not reported: on a storage source it is resolved against the bucket inside the connector's encrypted credentials, which the connector routes strip"}},"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}/sources/{id}":{"patch":{"operationId":"patch-api-v1-workspaces-{wsId}-sources-{id}","summary":"Update source","description":"Updates source name and/or description only. Schema and data are not changed here.","tags":["Sources"],"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/UpdateSourceSchema"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceEnvelope"}}}},"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"}}}}}}
```

## Create source from in-memory data

> Creates a new tabular source from a JSON array of records. Body: name, data (array of objects, min length 1), optional description, parentSourceId. Platform creates the source id and record, then hands the data to the data-service, which runs full ingest (type inference, null cleaning, schema), persists to storage, then runs ontology extraction and consolidation. The response carries schemaEntries, columnMetadata, documentCount, totalSize. Use when you have in-memory data (e.g. from an API) rather than a file; avoids file upload and matches UI upload behaviour including ontology.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"CreateSourceFromDataSchema":{"type":"object","properties":{"name":{"type":"string","description":"Source name"},"data":{"type":"array","items":{"type":"object","additionalProperties":{}},"minItems":1,"description":"Array of records; keys become columns, types are inferred during ingest"},"description":{"type":["string","null"]},"parentSourceId":{"type":["string","null"],"description":"Optional parent folder source to group under"}},"required":["name","data"]},"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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}/sources/from-data":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources-from-data","summary":"Create source from in-memory data","description":"Creates a new tabular source from a JSON array of records. Body: name, data (array of objects, min length 1), optional description, parentSourceId. Platform creates the source id and record, then hands the data to the data-service, which runs full ingest (type inference, null cleaning, schema), persists to storage, then runs ontology extraction and consolidation. The response carries schemaEntries, columnMetadata, documentCount, totalSize. Use when you have in-memory data (e.g. from an API) rather than a file; avoids file upload and matches UI upload behaviour including ontology.","tags":["Sources"],"parameters":[{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSourceFromDataSchema"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnspecifiedEnvelope"}}}},"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"}}}}}}
```

## Link sources into a workspace

> Makes org-level sources visible inside this workspace. Body: sourceIds (min 1), optional parentSourceId to place them under a folder. Linking a folder brings its whole subtree. Nothing is copied or moved — one source can be linked into many workspaces. Requires write standing on the workspace, not just the sources:write scope. Returns { linked, alreadyLinked }.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"LinkSchema":{"type":"object","properties":{"sourceIds":{"type":"array","items":{"type":"string"},"minItems":1},"parentSourceId":{"type":["string","null"]}},"required":["sourceIds"]},"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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}/sources/link":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources-link","summary":"Link sources into a workspace","description":"Makes org-level sources visible inside this workspace. Body: sourceIds (min 1), optional parentSourceId to place them under a folder. Linking a folder brings its whole subtree. Nothing is copied or moved — one source can be linked into many workspaces. Requires write standing on the workspace, not just the sources:write scope. Returns { linked, alreadyLinked }.","tags":["Sources"],"parameters":[{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkSchema"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnspecifiedEnvelope"}}}},"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"}}}}}}
```

## Unlink sources from a workspace

> Removes sources from this workspace. Body: sourceIds (min 1). Only the link is deleted — the org-level source, its data and its ontology concepts are left intact, and other workspaces keep their links. Removing a folder takes its descendants with it. Requires write standing on the workspace.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"UnlinkSchema":{"type":"object","properties":{"sourceIds":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["sourceIds"]},"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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}/sources/unlink":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources-unlink","summary":"Unlink sources from a workspace","description":"Removes sources from this workspace. Body: sourceIds (min 1). Only the link is deleted — the org-level source, its data and its ontology concepts are left intact, and other workspaces keep their links. Removing a folder takes its descendants with it. Requires write standing on the workspace.","tags":["Sources"],"parameters":[{"name":"wsId","in":"path","required":true,"schema":{"type":"string"},"description":"Path parameter: wsId"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnlinkSchema"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnspecifiedEnvelope"}}}},"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"}}}}}}
```

## Extend source with additional data

> Appends data to the source from an uploaded file. Request body: raw file bytes; use header x-filename or Content-Disposition for filename. Does not run ontology processing; schema is inferred from the existing source or file. Use to add more rows without replacing existing data.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"BinaryUpload":{"description":"Raw file bytes"},"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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"]}}}},"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}/sources/{id}/extend":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources-{id}-extend","summary":"Extend source with additional data","description":"Appends data to the source from an uploaded file. Request body: raw file bytes; use header x-filename or Content-Disposition for filename. Does not run ontology processing; schema is inferred from the existing source or file. Use to add more rows without replacing existing data.","tags":["Sources"],"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"},{"in":"header","name":"x-filename","required":true,"schema":{"type":"string","description":"Filename to store the upload under"},"description":"Filename to store the upload under"}],"requestBody":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/BinaryUpload"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnspecifiedEnvelope"}}}},"400":{"$ref":"#/components/responses/400"},"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"}}}}}}
```

## Get source records

> Returns paginated rows from the source. Query params: limit (default 50, max 1000), cursor (opaque, from the previous response's pagination.cursor). Data is read from the query engine's storage.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"PaginatedEnvelope":{"type":"object","properties":{"data":{"type":"array","items":{},"description":"Payload not declared in this repo"},"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"]}},"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"]}}}},"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}/sources/{id}/records":{"get":{"operationId":"get-api-v1-workspaces-{wsId}-sources-{id}-records","summary":"Get source records","description":"Returns paginated rows from the source. Query params: limit (default 50, max 1000), cursor (opaque, from the previous response's pagination.cursor). Data is read from the query engine's storage.","tags":["Sources"],"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"},{"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/PaginatedEnvelope"}}}},"400":{"$ref":"#/components/responses/400"},"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"}}}}}}
```

## Replace source data

> Replaces all data in the source with an uploaded file. Request body: raw file bytes; x-filename or Content-Disposition for filename. Ingest (type inference, schema) is applied, then mappings for columns the file no longer contains are detached and ontology extraction is requeued in every linked workspace so each automatically maintained dataset view can adopt the replacement schema. The data replacement can succeed even if ontology reconciliation is unavailable; in that case the response includes a warning telling the client to rerun extraction. Use when you want to refresh content without creating a new source.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"BinaryUpload":{"description":"Raw file bytes"},"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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"]}}}},"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}/sources/{id}/replace":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources-{id}-replace","summary":"Replace source data","description":"Replaces all data in the source with an uploaded file. Request body: raw file bytes; x-filename or Content-Disposition for filename. Ingest (type inference, schema) is applied, then mappings for columns the file no longer contains are detached and ontology extraction is requeued in every linked workspace so each automatically maintained dataset view can adopt the replacement schema. The data replacement can succeed even if ontology reconciliation is unavailable; in that case the response includes a warning telling the client to rerun extraction. Use when you want to refresh content without creating a new source.","tags":["Sources"],"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"},{"in":"header","name":"x-filename","required":true,"schema":{"type":"string","description":"Filename to store the upload under"},"description":"Filename to store the upload under"}],"requestBody":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/BinaryUpload"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnspecifiedEnvelope"}}}},"400":{"$ref":"#/components/responses/400"},"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"}}}}}}
```

## Retry ontology processing

> Retries ontology processing for a source that previously failed (e.g. ontologyStatus extraction\_failed or consolidation\_failed). If extraction failed, runs extraction inline then queues consolidation; if only consolidation failed, re-queues consolidation. Returns success when the retry is accepted; processing is asynchronous.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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}/sources/{id}/retry-ontology":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources-{id}-retry-ontology","summary":"Retry ontology processing","description":"Retries ontology processing for a source that previously failed (e.g. ontologyStatus extraction_failed or consolidation_failed). If extraction failed, runs extraction inline then queues consolidation; if only consolidation failed, re-queues consolidation. Returns success when the retry is accepted; processing is asynchronous.","tags":["Sources"],"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/UnspecifiedEnvelope"}}}},"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"}}}}}}
```

## Get source schema

> Returns source id, name, schema (schemaEntries), columnMetadata, and documentCount from platform MongoDB. No proxy; reflects the last known schema from upload or from-data. For live schema from storage, compare with records.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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}/sources/{id}/schema":{"get":{"operationId":"get-api-v1-workspaces-{wsId}-sources-{id}-schema","summary":"Get source schema","description":"Returns source id, name, schema (schemaEntries), columnMetadata, and documentCount from platform MongoDB. No proxy; reflects the last known schema from upload or from-data. For live schema from storage, compare with records.","tags":["Sources"],"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/UnspecifiedEnvelope"}}}},"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"}}}}}}
```

## Sync source from its connector

> Triggers a sync for a source that is backed by a live-data connector (e.g. scheduled pull). Only meaningful for sources with a connectionConfig that supports sync; no-op or error otherwise.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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}/sources/{id}/sync":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources-{id}-sync","summary":"Sync source from its connector","description":"Triggers a sync for a source that is backed by a live-data connector (e.g. scheduled pull). Only meaningful for sources with a connectionConfig that supports sync; no-op or error otherwise.","tags":["Sources"],"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/UnspecifiedEnvelope"}}}},"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"}}}}}}
```

## Upload file to source

> Uploads a file into this source (which must already exist). Request body: raw file bytes; x-filename or Content-Disposition for filename. The data-service parses the file (CSV, Excel, Parquet, etc.), runs full ingest with type inference, then runs ontology extraction and consolidation. For API-only flows, from-data is often simpler and returns the full source with schema.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"BinaryUpload":{"description":"Raw file bytes"},"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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"]}}}},"409":{"description":"Conflict","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}/sources/{id}/upload":{"post":{"operationId":"post-api-v1-workspaces-{wsId}-sources-{id}-upload","summary":"Upload file to source","description":"Uploads a file into this source (which must already exist). Request body: raw file bytes; x-filename or Content-Disposition for filename. The data-service parses the file (CSV, Excel, Parquet, etc.), runs full ingest with type inference, then runs ontology extraction and consolidation. For API-only flows, from-data is often simpler and returns the full source with schema.","tags":["Sources"],"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"},{"in":"header","name":"x-filename","required":true,"schema":{"type":"string","description":"Filename to store the upload under"},"description":"Filename to store the upload under"}],"requestBody":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/BinaryUpload"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnspecifiedEnvelope"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Export source

> Streams the source contents as a file. Path param format: csv, json, or parquet. Response is streaming. Requires exports:read scope.

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"Sources"}],"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":{"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"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"]}}}},"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}/sources/{id}/export/{format}":{"get":{"operationId":"get-api-v1-workspaces-{wsId}-sources-{id}-export-{format}","summary":"Export source","description":"Streams the source contents as a file. Path param format: csv, json, or parquet. Response is streaming. Requires exports:read scope.","tags":["Sources"],"parameters":[{"in":"path","name":"format","required":true,"schema":{"type":"string","enum":["csv","json","parquet"],"description":"Export format"},"description":"Export format"}],"responses":{"200":{"description":"Successful response","content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/UnspecifiedEnvelope"}}}},"400":{"$ref":"#/components/responses/400"},"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"}}}}}}
```