{"openapi":"3.1.0","info":{"title":"Dataset API","version":"1.1.0","description":"Stable API for versioned, traceable dataset releases. The dataset_builder implementation may evolve behind this contract."},"servers":[{"url":"https://api.datasets.nordicdevhouse.com/v1","description":"Production"},{"url":"https://sandbox.datasets.nordicdevhouse.com/v1","description":"Sandbox"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Datasets","description":"Discover managed datasets and their schema."},{"name":"Releases","description":"Inspect immutable, content-addressed releases."},{"name":"Queries","description":"Read bounded rows from a release."},{"name":"Builds","description":"Start and inspect dataset builder jobs."},{"name":"Synthesis","description":"Create synthetic dataset products and inspect their gated runs."}],"paths":{"/datasets":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"get":{"tags":["Datasets"],"operationId":"listDatasets","summary":"List datasets","responses":{"200":{"description":"Dataset catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"429":["rate_limited"],"500":["server_error"]}}},"/datasets/{dataset_id}":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/DatasetId"}],"get":{"tags":["Datasets"],"operationId":"getDataset","summary":"Get a dataset","responses":{"200":{"description":"Dataset definition","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dataset"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/datasets/{dataset_id}/releases":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/DatasetId"}],"get":{"tags":["Releases"],"operationId":"listDatasetReleases","summary":"List dataset releases","responses":{"200":{"description":"Release list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/datasets/{dataset_id}/releases/{release_id}":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/DatasetId"},{"$ref":"#/components/parameters/ReleaseId"}],"get":{"tags":["Releases"],"operationId":"getDatasetRelease","summary":"Get a dataset release","responses":{"200":{"description":"Immutable release manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Release"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/datasets/{dataset_id}/query":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/DatasetId"}],"post":{"tags":["Queries"],"operationId":"queryDataset","summary":"Query released rows","description":"Returns a bounded page of rows together with release quality and lineage metadata.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"},"example":{"release_id":"dsv-20260813","filters":{"make":"Toyota"},"fields":["make","model","year","price_eur"],"limit":50}}}},"responses":{"200":{"description":"Rows returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"400":["validation_error"],"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/datasets/{dataset_id}/releases/{release_id}/download":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/DatasetId"},{"$ref":"#/components/parameters/ReleaseId"}],"get":{"tags":["Releases"],"operationId":"downloadDatasetRelease","summary":"Download a release","parameters":[{"$ref":"#/components/parameters/Format"}],"responses":{"200":{"description":"Release artifact","content":{"application/x-ndjson":{"schema":{"type":"string","format":"binary"}},"text/csv":{"schema":{"type":"string","format":"binary"}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/synthetic-datasets":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"get":{"tags":["Synthesis"],"operationId":"listSyntheticDatasets","summary":"List synthetic dataset definitions","responses":{"200":{"description":"Synthetic dataset definitions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyntheticDatasetList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"429":["rate_limited"],"500":["server_error"]}},"post":{"tags":["Synthesis"],"operationId":"createSyntheticDataset","summary":"Create a synthetic dataset definition","description":"Creates a versionable recipe against an immutable seed release. The definition remains a draft until a synthesis run passes both publication gates.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyntheticDatasetRequest"},"example":{"id":"synthetic-finnish-vehicles","name":"Synthetic Finnish vehicles","source_dataset_id":"finnish-vehicle-market-listings","source_release_id":"dsv-preview-finnish-vehicle-market-listings","recipe":{"algorithm":"statistical-tabular-v1","row_count":10000,"seed":42,"sensitive_fields":["seller_name","seller_email"]}}}}},"responses":{"201":{"description":"Synthetic dataset definition","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyntheticDataset"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"400":["validation_error"],"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/synthetic-datasets/{synthetic_dataset_id}":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/SyntheticDatasetId"}],"get":{"tags":["Synthesis"],"operationId":"getSyntheticDataset","summary":"Get a synthetic dataset definition","responses":{"200":{"description":"Synthetic dataset definition","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyntheticDataset"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/synthetic-datasets/{synthetic_dataset_id}/runs":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/SyntheticDatasetId"}],"post":{"tags":["Synthesis"],"operationId":"runSyntheticDataset","summary":"Run a synthetic dataset recipe","description":"Generates rows and publishes an immutable release only when both fidelity and privacy reports pass.","responses":{"202":{"description":"Synthesis run accepted or completed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisRun"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"400":["validation_error"],"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/synthetic-datasets/{synthetic_dataset_id}/releases":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/SyntheticDatasetId"}],"get":{"tags":["Synthesis","Releases"],"operationId":"listSyntheticDatasetReleases","summary":"List published synthetic releases","responses":{"200":{"description":"Synthetic releases that passed publication gates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/synthesis-runs":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"get":{"tags":["Synthesis"],"operationId":"listSynthesisRuns","summary":"List synthesis runs","responses":{"200":{"description":"Synthesis runs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisRunList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"429":["rate_limited"],"500":["server_error"]}}},"/synthesis-runs/{run_id}":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/SynthesisRunId"}],"get":{"tags":["Synthesis"],"operationId":"getSynthesisRun","summary":"Get a synthesis run and its reports","responses":{"200":{"description":"Synthesis run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynthesisRun"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/builds":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"get":{"tags":["Builds"],"operationId":"listDatasetBuilds","summary":"List dataset builds","responses":{"200":{"description":"Build jobs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuildList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"429":["rate_limited"],"500":["server_error"]}},"post":{"tags":["Builds"],"operationId":"createDatasetBuild","summary":"Start a dataset build","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuildRequest"},"example":{"dataset_id":"finnish-vehicle-market-listings","definition_version":"0.2.0","source_snapshot_ids":["snapshot-20260813"]}}}},"responses":{"202":{"description":"Build accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Build"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"400":["validation_error"],"401":["authentication_error"],"429":["rate_limited"],"500":["server_error"]}}},"/builds/{build_id}":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"},{"$ref":"#/components/parameters/BuildId"}],"get":{"tags":["Builds"],"operationId":"getDatasetBuild","summary":"Get a dataset build","responses":{"200":{"description":"Build status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Build"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}},"delete":{"tags":["Builds"],"operationId":"cancelDatasetBuild","summary":"Cancel a dataset build","responses":{"200":{"description":"Build cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Build"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"404":["not_found"],"429":["rate_limited"],"500":["server_error"]}}},"/health":{"parameters":[{"$ref":"#/components/parameters/ApiVersion"}],"get":{"tags":["Datasets"],"operationId":"getDatasetApiHealth","summary":"Get Dataset API health","responses":{"200":{"description":"Service health","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}},"x-error-codes":{"401":["authentication_error"],"429":["rate_limited"],"500":["server_error"]}}}},"components":{"parameters":{"ApiVersion":{"name":"X-API-Version","in":"header","required":false,"schema":{"type":"string","default":"1"}},"DatasetId":{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z][a-z0-9-]+$"}},"ReleaseId":{"name":"release_id","in":"path","required":true,"schema":{"type":"string","minLength":3}},"SyntheticDatasetId":{"name":"synthetic_dataset_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z][a-z0-9-]{2,48}$"}},"SynthesisRunId":{"name":"run_id","in":"path","required":true,"schema":{"type":"string","minLength":3}},"BuildId":{"name":"build_id","in":"path","required":true,"schema":{"type":"string","minLength":3}},"Format":{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["jsonl","csv","parquet"],"default":"jsonl"}}},"responses":{"BadRequest":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServerError":{"description":"Temporary server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"DatasetField":{"type":"object","required":["name","type","required"],"properties":{"name":{"type":"string"},"type":{"type":"string"},"format":{"type":"string"},"unit":{"type":"string"},"required":{"type":"boolean"}}},"Dataset":{"type":"object","required":["id","version","name","row_entity_type","fields"],"properties":{"id":{"type":"string"},"dataset_id":{"type":"string"},"version":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"row_entity_type":{"type":"string"},"market":{"type":"string"},"language":{"type":"string"},"jurisdiction":{"type":"string"},"data_origin":{"type":"string","enum":["observed","synthetic"],"default":"observed"},"source_dataset_id":{"type":"string"},"source_release_id":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DatasetField"}},"identity_fields":{"type":"array","items":{"type":"string"}},"latest_release":{"$ref":"#/components/schemas/Release"},"release_count":{"type":"integer"}}},"DatasetList":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Dataset"}},"meta":{"$ref":"#/components/schemas/ListMeta"}}},"Release":{"type":"object","required":["id","dataset_id","dataset_version","schema_version","quality_status","immutable"],"properties":{"id":{"type":"string"},"release_id":{"type":"string"},"dataset_id":{"type":"string"},"dataset_version":{"type":"string"},"definition_version":{"type":"string"},"schema_version":{"type":"string","example":"2.0.0"},"row_entity_type":{"type":"string"},"quality_status":{"type":"string","enum":["complete","partial"]},"data_origin":{"type":"string","enum":["observed","synthetic"]},"source_dataset_id":{"type":"string"},"source_release_id":{"type":"string"},"synthesis_recipe":{"type":"string"},"synthesis_seed":{"type":"integer"},"counts":{"type":"object","additionalProperties":{"type":"integer"}},"parent_release_id":{"type":["string","null"]},"artifacts":{"type":"object","additionalProperties":{"type":"string"}},"immutable":{"type":"boolean"},"published_at":{"type":"string","format":"date-time"}}},"ReleaseList":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Release"}},"meta":{"$ref":"#/components/schemas/ListMeta"}}},"QueryRequest":{"type":"object","properties":{"release_id":{"type":"string"},"filters":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":"string"}}]}},"fields":{"type":"array","items":{"type":"string"},"maxItems":100},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":100}}},"QueryResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"meta":{"type":"object","required":["count","dataset_id","release_id","quality_status","partial"],"properties":{"count":{"type":"integer"},"dataset_id":{"type":"string"},"release_id":{"type":"string"},"dataset_version":{"type":"string"},"data_origin":{"type":"string","enum":["observed","synthetic"]},"quality_status":{"type":"string"},"partial":{"type":"boolean"}}}}},"SyntheticRecipe":{"type":"object","required":["row_count"],"properties":{"algorithm":{"type":"string","enum":["statistical-tabular-v1"],"default":"statistical-tabular-v1"},"row_count":{"type":"integer","minimum":1,"maximum":100000},"seed":{"type":"integer","default":1},"constraints":{"type":"object","additionalProperties":{"type":"object","properties":{"min":{"type":"number"},"max":{"type":"number"},"allowed":{"type":"array","items":{}}}}},"sensitive_fields":{"type":"array","items":{"type":"string"},"uniqueItems":true}}},"SyntheticDatasetRequest":{"type":"object","required":["name","source_dataset_id","recipe"],"properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9-]{2,48}$"},"name":{"type":"string","minLength":1},"description":{"type":"string"},"source_dataset_id":{"type":"string"},"source_release_id":{"type":"string"},"recipe":{"$ref":"#/components/schemas/SyntheticRecipe"}}},"SyntheticDataset":{"type":"object","required":["id","name","status","data_origin","source_dataset_id","source_release_id","recipe","created_at"],"properties":{"id":{"type":"string"},"dataset_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["draft","published"]},"data_origin":{"type":"string","enum":["synthetic"]},"source_dataset_id":{"type":"string"},"source_release_id":{"type":"string"},"recipe":{"$ref":"#/components/schemas/SyntheticRecipe"},"latest_release":{"$ref":"#/components/schemas/Release"},"release_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"}}},"SyntheticDatasetList":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SyntheticDataset"}},"meta":{"$ref":"#/components/schemas/ListMeta"}}},"FidelityReport":{"type":"object","required":["status","schema_coverage","category_coverage","numeric_mean_delta_ratio"],"properties":{"status":{"type":"string","enum":["passed","failed"]},"schema_coverage":{"type":"number","minimum":0,"maximum":1},"category_coverage":{"type":"number","minimum":0,"maximum":1},"numeric_mean_delta_ratio":{"type":"number","minimum":0}}},"PrivacyReport":{"type":"object","required":["status","exact_source_matches","direct_identifier_fields_removed"],"properties":{"status":{"type":"string","enum":["passed","failed"]},"exact_source_matches":{"type":"integer","minimum":0},"direct_identifier_fields_removed":{"type":"array","items":{"type":"string"}}}},"SynthesisQualityGate":{"type":"object","required":["status","checks"],"properties":{"status":{"type":"string","enum":["passed","failed"]},"checks":{"type":"array","items":{"type":"string","enum":["fidelity","privacy"]}}}},"SynthesisRun":{"type":"object","required":["id","synthetic_dataset_id","status","quality_gate","fidelity_report","privacy_report","created_at"],"properties":{"id":{"type":"string"},"synthetic_dataset_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","completed","failed"]},"quality_gate":{"$ref":"#/components/schemas/SynthesisQualityGate"},"fidelity_report":{"$ref":"#/components/schemas/FidelityReport"},"privacy_report":{"$ref":"#/components/schemas/PrivacyReport"},"release":{"oneOf":[{"$ref":"#/components/schemas/Release"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"}}},"SynthesisRunList":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SynthesisRun"}},"meta":{"$ref":"#/components/schemas/ListMeta"}}},"BuildRequest":{"type":"object","required":["dataset_id"],"properties":{"dataset_id":{"type":"string"},"definition_version":{"type":"string"},"source_snapshot_ids":{"type":"array","items":{"type":"string"}}}},"Build":{"type":"object","required":["id","status","dataset_id"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","completed","failed","cancelled"]},"dataset_id":{"type":"string"},"definition_version":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}},"BuildList":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Build"}},"meta":{"$ref":"#/components/schemas/ListMeta"}}},"Health":{"type":"object","required":["status","contract_version","adapter_version","release_schema_version"],"properties":{"status":{"type":"string"},"mode":{"type":"string"},"contract_version":{"type":"string"},"adapter_version":{"type":"string"},"release_schema_version":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}}}},"ListMeta":{"type":"object","required":["count"],"properties":{"count":{"type":"integer"},"contract_version":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key"}}}}