1{"responses":{"200":{"description":"List of datasets. When `status=true` is specified, each dataset includes `status` and error metadata (`error`, `error_message`) when applicable.","content":{"application/json":{"schema":{"type":"object","description":"Dataset information returned by the `/v1/datasets` endpoint.","required":["from","name","replication_enabled","acceleration_enabled"],"properties":{"acceleration_enabled":{"type":"boolean","description":"Whether acceleration is enabled for the dataset"},"error":{"oneOf":[{"type":"null"},{"description":"An optional error type/code for the dataset status.\nOnly populated when `status=true` and the dataset status is `Error`.\nExample:\n`{ \"category\": \"dataset\", \"type\": \"auth\", \"code\": \"dataset.auth\" }`.","type":"object","required":["category","type","code"],"properties":{"category":{"description":"High-level component category where the error originated.","type":"string","enum":["dataset","model","worker","runtime"],"title":"ComponentErrorCategory"},"code":{"type":"string","description":"Stable machine-readable code (`{category}.{type}`), e.g. `dataset.auth`."},"type":{"description":"Canonical error type intended for programmatic handling.","type":"string","enum":["auth","connection","timeout","validation","not_found","permission","rate_limit","internal","unknown"],"title":"ComponentErrorType"}},"title":"ComponentError"}]},"error_message":{"type":["string","null"],"description":"An optional error message describing why the dataset entered an error state.\nOnly populated when `status=true`, the dataset status is `Error`, and an error message was recorded.\nThis value is intended for user-visible display."},"from":{"type":"string","description":"The source where the dataset is located (e.g., `postgres:syncs`)"},"name":{"type":"string","description":"The name of the dataset"},"properties":{"type":"object","description":"Custom properties for the dataset","additionalProperties":{},"propertyNames":{"type":"string"}},"replication_enabled":{"type":"boolean","description":"Whether replication is enabled for the dataset"},"status":{"oneOf":[{"type":"null"},{"description":"The current status of the dataset. Only included when `status=true` query parameter is specified.\nPossible values: `Initializing`, `Ready`, `Disabled`, `Error`, `Refreshing`, `ShuttingDown`.","oneOf":[{"type":"string","description":"The component is initializing and not yet ready","enum":["Initializing"]},{"type":"string","description":"The component is ready to accept connections","enum":["Ready"]},{"type":"string","description":"The component is disabled and not running","enum":["Disabled"]},{"type":"object","description":"An error occurred in the component, with an optional error message","required":["Error"],"properties":{"Error":{"type":["string","null"],"description":"An error occurred in the component, with an optional error message"}}},{"type":"string","description":"The component is in the process of refreshing its state","enum":["Refreshing"]},{"type":"string","description":"The component is in the process of shutting down","enum":["ShuttingDown"]}],"example":"Ready","title":"String"}]}},"title":"DatasetInfo"},"example":[{"from":"postgres:syncs","name":"daily_journal_accelerated","replication_enabled":false,"acceleration_enabled":true,"status":"Ready","error":null,"error_message":null},{"from":"databricks:hive_metastore.default.messages","name":"messages_accelerated","replication_enabled":false,"acceleration_enabled":true,"status":"Error","error":{"category":"dataset","type":"auth","code":"dataset.auth"},"error_message":"Unable to authenticate with datasource credentials"},{"from":"postgres:aidemo_messages","name":"general","replication_enabled":false,"acceleration_enabled":false,"status":"Initializing","error":null,"error_message":null}]},"text/csv":{"schema":{"type":"string"},"example":"\nfrom,name,replication_enabled,acceleration_enabled,status,error,error_message\npostgres:syncs,daily_journal_accelerated,false,true,Ready,,\ndatabricks:hive_metastore.default.messages,messages_accelerated,false,true,Error,dataset.auth,Unable to authenticate with datasource credentials\npostgres:aidemo_messages,general,false,false,Initializing,,\n"}}},"500":{"description":"Internal server error occurred while processing datasets","content":{"text/plain":{"schema":{"type":"string"},"example":"An unexpected error occurred while processing datasets"}}}}}

1{"responses":{"200":{"description":"List of datasets. When `status=true` is specified, each dataset includes `status` and error metadata (`error`, `error_message`) when applicable.","content":{"application/json":{"schema":{"type":"object","description":"Dataset information returned by the `/v1/datasets` endpoint.","required":["from","name","replication_enabled","acceleration_enabled"],"properties":{"acceleration_enabled":{"type":"boolean","description":"Whether acceleration is enabled for the dataset"},"error":{"oneOf":[{"type":"null"},{"description":"An optional error type/code for the dataset status.\nOnly populated when `status=true` and the dataset status is `Error`.\nExample:\n`{ \"category\": \"dataset\", \"type\": \"auth\", \"code\": \"dataset.auth\" }`.","type":"object","required":["category","type","code"],"properties":{"category":{"description":"High-level component category where the error originated.","type":"string","enum":["dataset","model","worker","runtime"],"title":"ComponentErrorCategory"},"code":{"type":"string","description":"Stable machine-readable code (`{category}.{type}`), e.g. `dataset.auth`."},"type":{"description":"Canonical error type intended for programmatic handling.","type":"string","enum":["auth","connection","timeout","validation","not_found","permission","rate_limit","internal","unknown"],"title":"ComponentErrorType"}},"title":"ComponentError"}]},"error_message":{"type":["string","null"],"description":"An optional error message describing why the dataset entered an error state.\nOnly populated when `status=true`, the dataset status is `Error`, and an error message was recorded.\nThis value is intended for user-visible display."},"from":{"type":"string","description":"The source where the dataset is located (e.g., `postgres:syncs`)"},"name":{"type":"string","description":"The name of the dataset"},"properties":{"type":"object","description":"Custom properties for the dataset","additionalProperties":{},"propertyNames":{"type":"string"}},"replication_enabled":{"type":"boolean","description":"Whether replication is enabled for the dataset"},"status":{"oneOf":[{"type":"null"},{"description":"The current status of the dataset. Only included when `status=true` query parameter is specified.\nPossible values: `Initializing`, `Ready`, `Disabled`, `Error`, `Refreshing`, `ShuttingDown`.","oneOf":[{"type":"string","description":"The component is initializing and not yet ready","enum":["Initializing"]},{"type":"string","description":"The component is ready to accept connections","enum":["Ready"]},{"type":"string","description":"The component is disabled and not running","enum":["Disabled"]},{"type":"object","description":"An error occurred in the component, with an optional error message","required":["Error"],"properties":{"Error":{"type":["string","null"],"description":"An error occurred in the component, with an optional error message"}}},{"type":"string","description":"The component is in the process of refreshing its state","enum":["Refreshing"]},{"type":"string","description":"The component is in the process of shutting down","enum":["ShuttingDown"]}],"example":"Ready","title":"String"}]}},"title":"DatasetInfo"},"example":[{"from":"postgres:syncs","name":"daily_journal_accelerated","replication_enabled":false,"acceleration_enabled":true,"status":"Ready","error":null,"error_message":null},{"from":"databricks:hive_metastore.default.messages","name":"messages_accelerated","replication_enabled":false,"acceleration_enabled":true,"status":"Error","error":{"category":"dataset","type":"auth","code":"dataset.auth"},"error_message":"Unable to authenticate with datasource credentials"},{"from":"postgres:aidemo_messages","name":"general","replication_enabled":false,"acceleration_enabled":false,"status":"Initializing","error":null,"error_message":null}]},"text/csv":{"schema":{"type":"string"},"example":"\nfrom,name,replication_enabled,acceleration_enabled,status,error,error_message\npostgres:syncs,daily_journal_accelerated,false,true,Ready,,\ndatabricks:hive_metastore.default.messages,messages_accelerated,false,true,Error,dataset.auth,Unable to authenticate with datasource credentials\npostgres:aidemo_messages,general,false,false,Initializing,,\n"}}},"500":{"description":"Internal server error occurred while processing datasets","content":{"text/plain":{"schema":{"type":"string"},"example":"An unexpected error occurred while processing datasets"}}}}}