@malloy-publisher/server 0.0.119 → 0.0.120

package/dist/app/api-doc.yaml

@@ -21,12 +21,10 @@ info:
     ```
     Projects
     ├── Connections
-    ├── Packages
-    │   ├── Models
-    │   ├── Notebooks
-    │   ├── Databases
-    │   └── Schedules
-    └── Watch Mode
+    └── Packages
+        ├── Models
+        ├── Notebooks
+        └── Databases
     ```
 
     For examples, see the Malloy samples packages (https://github.com/malloydata/malloy-samples) repository.
@@ -49,12 +47,8 @@ tags:
     description: Malloy model access and compilation operations
   - name: notebooks
     description: Malloy notebook access and execution operations
-  - name: queryresults
-    description: Query execution and result retrieval operations
   - name: databases
     description: Embedded database management and access
-  - name: schedules
-    description: Scheduled task management and monitoring
   - name: watch-mode
     description: Real-time file watching for development workflows
 
@@ -77,39 +71,6 @@ paths:
               schema:
                 $ref: "#/components/schemas/ServerStatus"
 
-  /connections/test:
-    post:
-      tags:
-        - connections
-      operationId: test-connection-configuration
-      summary: Test database connection configuration
-      description: |
-        Validates a database connection configuration without adding it to any project.
-        This endpoint allows you to test connection parameters, credentials, and network
-        connectivity before committing the connection to a project. Useful for troubleshooting
-        connection issues and validating configurations during setup.
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/Connection"
-      responses:
-        "200":
-          description: Connection test result
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ConnectionStatus"
-        "400":
-          $ref: "#/components/responses/BadRequest"
-        "401":
-          $ref: "#/components/responses/Unauthorized"
-        "404":
-          $ref: "#/components/responses/NotFound"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-
   /projects:
     get:
       tags:
@@ -327,16 +288,16 @@ paths:
         "500":
           $ref: "#/components/responses/InternalServerError"
 
-  /projects/{projectName}/connections/{connectionName}/test:
+  /projects/{projectName}/connections/{connectionName}/schemas:
     get:
       tags:
         - connections
-      operationId: test-connection
-      summary: Test existing project connection
+      operationId: list-schemas
+      summary: List database schemas
       description: |
-        Tests the connectivity and configuration of an existing database connection within a project.
-        This endpoint validates that the connection can be established, credentials are valid,
-        and the database is accessible. Useful for monitoring connection health and troubleshooting.
+        Retrieves a list of all schemas (databases) available in the specified connection.
+        Each schema includes metadata such as name, description, and whether it's the default schema.
+        This endpoint is useful for exploring the database structure and discovering available data sources.
       parameters:
         - name: projectName
           in: path
@@ -352,11 +313,13 @@ paths:
             $ref: "#/components/schemas/IdentifierPattern"
       responses:
         "200":
-          description: OK
+          description: A list of schemas available in the connection with metadata
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ConnectionStatus"
+                type: array
+                items:
+                  $ref: "#/components/schemas/Schema"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -364,19 +327,16 @@ paths:
         "500":
           $ref: "#/components/responses/InternalServerError"
 
-  /projects/{projectName}/connections/{connectionName}/sqlSource:
+  /projects/{projectName}/connections/{connectionName}/schemas/{schemaName}/tables:
     get:
       tags:
         - connections
-      operationId: get-sqlsource
-      deprecated: true
-      summary: Get SQL source (deprecated)
+      operationId: list-tables
+      summary: List tables in database
       description: |
-        **DEPRECATED**: This endpoint is deprecated and may be removed in future versions.
-        Use the POST version instead for better security and functionality.
-
-        Creates a Malloy source from a SQL statement using the specified connection.
-        The SQL statement is executed to generate a source definition that can be used in Malloy models.
+        Retrieves a list of all tables and views available in the specified database schema.
+        This endpoint is useful for discovering available data sources and exploring the database
+        structure. The schema must exist in the connection for this operation to succeed.
       parameters:
         - name: projectName
           in: path
@@ -390,65 +350,21 @@ paths:
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
-        - name: sqlStatement
-          in: query
-          description: SQL statement
-          required: false
-          schema:
-            type: string
-      responses:
-        "200":
-          description: SQL source information
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/SqlSource"
-        "401":
-          $ref: "#/components/responses/Unauthorized"
-        "404":
-          $ref: "#/components/responses/NotFound"
-        "500":
-          $ref: "#/components/responses/InternalServerError"
-    post:
-      tags:
-        - connections
-      operationId: post-sqlsource
-      summary: Create SQL source from statement
-      description: |
-        Creates a Malloy source from a SQL statement using the specified database connection.
-        The SQL statement is executed to generate a source definition that can be used in Malloy models.
-        This is the preferred method over the deprecated GET version as it provides better security
-        and supports larger SQL statements.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of the project
-          required: true
-          schema:
-            $ref: "#/components/schemas/IdentifierPattern"
-        - name: connectionName
+        - name: schemaName
           in: path
-          description: Name of the connection
+          description: Name of the schema
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
-      requestBody:
-        description: SQL statement to fetch the SQL source
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                sqlStatement:
-                  type: string
       responses:
         "200":
-          description: SQL source information
+          description: A list of table names available in the specified schema
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/SqlSource"
+                type: array
+                items:
+                  $ref: "#/components/schemas/Table"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -456,16 +372,17 @@ paths:
         "500":
           $ref: "#/components/responses/InternalServerError"
 
-  /projects/{projectName}/connections/{connectionName}/tableSource:
+  /projects/{projectName}/connections/{connectionName}/schemas/{schemaName}/tables/{tablePath}:
     get:
       tags:
         - connections
-      operationId: get-tablesource
-      summary: Get table source information
+      operationId: get-table
+      summary: Get table details from database
       description: |
-        Retrieves information about a specific table or view from the database connection.
-        This includes table schema, column definitions, and metadata. The table can be specified
-        by either tableKey or tablePath parameters, depending on the database type.
+        Retrieves a table from the specified database schema.
+        This endpoint is useful for discovering available data sources and exploring the database
+        structure. The schema must exist in the connection for this operation to succeed.
+        The tablePath is the full path to the table, including the schema name.
       parameters:
         - name: projectName
           in: path
@@ -479,25 +396,25 @@ paths:
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
-        - name: tableKey
-          in: query
-          description: Table key
-          required: false
+        - name: schemaName
+          in: path
+          description: Name of the schema
+          required: true
           schema:
-            type: string
+            $ref: "#/components/schemas/IdentifierPattern"
         - name: tablePath
-          in: query
-          description: Table path
-          required: false
+          in: path
+          description: Full path to the table
+          required: true
           schema:
-            type: string
+            $ref: "#/components/schemas/IdentifierPattern"
       responses:
         "200":
-          description: Table source information
+          description: Table information
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TableSource"
+                $ref: "#/components/schemas/Table"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -505,16 +422,20 @@ paths:
         "500":
           $ref: "#/components/responses/InternalServerError"
 
-  /projects/{projectName}/connections/{connectionName}/schemas/{schemaName}/tables:
+  # TODO: Remove this endpoint. 
+  /projects/{projectName}/connections/{connectionName}/sqlSource:
     get:
       tags:
         - connections
-      operationId: list-tables
-      summary: List tables in database schema
+      operationId: get-sqlsource
+      deprecated: true
+      summary: Get SQL source (deprecated)
       description: |
-        Retrieves a list of all tables and views available in the specified database schema.
-        This endpoint is useful for discovering available data sources and exploring the database
-        structure. The schema must exist in the connection for this operation to succeed.
+        **DEPRECATED**: This endpoint is deprecated and may be removed in future versions.
+        Use the POST version instead for better security and functionality.
+
+        Creates a Malloy source from a SQL statement using the specified connection.
+        The SQL statement is executed to generate a source definition that can be used in Malloy models.
       parameters:
         - name: projectName
           in: path
@@ -528,21 +449,19 @@ paths:
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
-        - name: schemaName
-          in: path
-          description: Name of the schema
-          required: true
+        - name: sqlStatement
+          in: query
+          description: SQL statement
+          required: false
           schema:
-            $ref: "#/components/schemas/IdentifierPattern"
+            type: string
       responses:
         "200":
-          description: A list of table names available in the specified schema
+          description: SQL source information
           content:
             application/json:
               schema:
-                type: array
-                items:
-                  type: string
+                $ref: "#/components/schemas/SqlSource"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -550,16 +469,14 @@ paths:
         "500":
           $ref: "#/components/responses/InternalServerError"
 
-  /projects/{projectName}/connections/{connectionName}/schemas:
-    get:
+    post:
       tags:
         - connections
-      operationId: list-schemas
-      summary: List database schemas
+      operationId: post-sqlsource
+      summary: Create SQL source from statement
       description: |
-        Retrieves a list of all schemas (databases) available in the specified connection.
-        Each schema includes metadata such as name, description, and whether it's the default schema.
-        This endpoint is useful for exploring the database structure and discovering available data sources.
+        Creates a Malloy source from a SQL statement using the specified database connection.
+        The SQL statement is executed to generate a source definition that can be used in Malloy models.
       parameters:
         - name: projectName
           in: path
@@ -573,15 +490,23 @@ paths:
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
+      requestBody:
+        description: SQL statement to fetch the SQL source
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                sqlStatement:
+                  type: string
       responses:
         "200":
-          description: A list of schemas available in the connection with metadata
+          description: SQL source information
           content:
             application/json:
               schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/SchemaName"
+                $ref: "#/components/schemas/SqlSource"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -589,19 +514,15 @@ paths:
         "500":
           $ref: "#/components/responses/InternalServerError"
 
-  /projects/{projectName}/connections/{connectionName}/queryData:
-    get:
+  /projects/{projectName}/connections/{connectionName}/sqlQuery:
+    post:
       tags:
         - connections
-      operationId: get-querydata
-      deprecated: true
-      summary: Execute SQL query (deprecated)
+      operationId: post-querydata
+      summary: Execute SQL query
       description: |
-        **DEPRECATED**: This endpoint is deprecated and may be removed in future versions.
-        Use the POST version instead for better security and functionality.
-
         Executes a SQL statement against the specified database connection and returns the results.
-        The query results include data, metadata, and execution information.
+        The results include data, metadata, and execution information.
       parameters:
         - name: projectName
           in: path
@@ -615,18 +536,22 @@ paths:
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
-        - name: sqlStatement
-          in: query
-          description: SQL statement
-          required: false
-          schema:
-            type: string
         - name: options
           in: query
           description: Options
           required: false
           schema:
             type: string
+      requestBody:
+        description: SQL statement to execute
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                sqlStatement:
+                  type: string
       responses:
         "200":
           description: Query execution results
@@ -640,15 +565,15 @@ paths:
           $ref: "#/components/responses/NotFound"
         "500":
           $ref: "#/components/responses/InternalServerError"
+  /projects/{projectName}/connections/{connectionName}/sqlTemporaryTable:
     post:
       tags:
         - connections
-      operationId: post-querydata
-      summary: Execute SQL query
+      operationId: post-temporarytable
+      summary: Create temporary table
       description: |
-        Executes a SQL statement against the specified database connection and returns the results.
-        This is the preferred method over the deprecated GET version as it provides better security
-        and supports larger SQL statements. The results include data, metadata, and execution information.
+        Creates a temporary table from a SQL statement using the specified database connection.
+        Temporary tables are useful for storing intermediate results during complex queries and data processing workflows.
       parameters:
         - name: projectName
           in: path
@@ -662,14 +587,8 @@ paths:
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
-        - name: options
-          in: query
-          description: Options
-          required: false
-          schema:
-            type: string
       requestBody:
-        description: SQL statement to execute
+        description: SQL statement to create the temporary table
         required: true
         content:
           application/json:
@@ -680,11 +599,11 @@ paths:
                   type: string
       responses:
         "200":
-          description: Query execution results
+          description: Temporary table information
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/QueryData"
+                $ref: "#/components/schemas/TemporaryTable"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -692,6 +611,7 @@ paths:
         "500":
           $ref: "#/components/responses/InternalServerError"
 
+  # TODO: Remove this endpoint. 
   /projects/{projectName}/connections/{connectionName}/temporaryTable:
     get:
       tags:
@@ -717,36 +637,92 @@ paths:
           description: Name of the connection
           required: true
           schema:
-            $ref: "#/components/schemas/IdentifierPattern"
-        - name: sqlStatement
+            $ref: "#/components/schemas/IdentifierPattern"
+        - name: sqlStatement
+          in: query
+          description: SQL statement
+          required: false
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Temporary table information
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TemporaryTable"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+        "500":
+          $ref: "#/components/responses/InternalServerError"
+
+  # TODO: Remove this endpoint. This is deprecated and replaced by /projects/{projectName}/connections/{connectionName}/table resource.
+  /projects/{projectName}/connections/{connectionName}/tableSource:
+    get:
+      tags:
+        - connections
+      operationId: get-tablesource
+      summary: Get table source information
+      deprecated: true
+      description: |
+        Retrieves information about a specific table or view from the database connection.
+        This includes table schema, column definitions, and metadata. The table can be specified
+        by either tableKey or tablePath parameters, depending on the database type.
+      parameters:
+        - name: projectName
+          in: path
+          description: Name of the project
+          required: true
+          schema:
+            $ref: "#/components/schemas/IdentifierPattern"
+        - name: connectionName
+          in: path
+          description: Name of the connection
+          required: true
+          schema:
+            $ref: "#/components/schemas/IdentifierPattern"
+        - name: tableKey
+          in: query
+          description: Table key
+          required: false
+          schema:
+            type: string
+        - name: tablePath
           in: query
-          description: SQL statement
+          description: Table path
           required: false
           schema:
             type: string
       responses:
         "200":
-          description: Temporary table information
+          description: Table source information
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TemporaryTable"
+                $ref: "#/components/schemas/TableSource"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
           $ref: "#/components/responses/NotFound"
         "500":
           $ref: "#/components/responses/InternalServerError"
-    post:
+
+  # TODO: Remove this endpoint. 
+  /projects/{projectName}/connections/{connectionName}/queryData:
+    get:
       tags:
         - connections
-      operationId: post-temporarytable
-      summary: Create temporary table
+      operationId: get-querydata
+      deprecated: true
+      summary: Execute SQL query (deprecated)
       description: |
-        Creates a temporary table from a SQL statement using the specified database connection.
-        This is the preferred method over the deprecated GET version as it provides better security
-        and supports larger SQL statements. Temporary tables are useful for storing intermediate
-        results during complex queries and data processing workflows.
+        **DEPRECATED**: This endpoint is deprecated and may be removed in future versions.
+        Use the POST version instead for better security and functionality.
+
+        Executes a SQL statement against the specified database connection and returns the results.
+        The query results include data, metadata, and execution information.
       parameters:
         - name: projectName
           in: path
@@ -760,23 +736,25 @@ paths:
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
-      requestBody:
-        description: SQL statement to create the temporary table
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                sqlStatement:
-                  type: string
+        - name: sqlStatement
+          in: query
+          description: SQL statement
+          required: false
+          schema:
+            type: string
+        - name: options
+          in: query
+          description: Options
+          required: false
+          schema:
+            type: string
       responses:
         "200":
-          description: Temporary table information
+          description: Query execution results
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TemporaryTable"
+                $ref: "#/components/schemas/QueryData"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -1084,16 +1062,17 @@ paths:
         "501":
           $ref: "#/components/responses/NotImplemented"
 
-  /projects/{projectName}/packages/{packageName}/notebooks:
-    get:
+  /projects/{projectName}/packages/{packageName}/models/{path}/query:
+    post:
       tags:
-        - notebooks
-      operationId: list-notebooks
-      summary: List package notebooks
+        - models
+      operationId: execute-query-model
+      summary: Execute Malloy query
       description: |
-        Retrieves a list of all Malloy notebooks within the specified package. Each notebook entry
-        includes the relative path, package name, and any compilation errors. This endpoint
-        is useful for discovering available notebooks and checking their status.
+        Executes a Malloy query against a model and returns the results. The query can be specified
+        as a raw Malloy query string or by referencing a named query within the model. This endpoint
+        supports both ad-hoc queries and predefined model queries, making it flexible for various
+        use cases including data exploration, reporting, and application integration.
       parameters:
         - name: projectName
           in: path
@@ -1107,21 +1086,27 @@ paths:
           required: true
           schema:
             $ref: "#/components/schemas/IdentifierPattern"
-        - name: versionId
-          in: query
-          description: Version identifier for the package
-          required: false
+        - name: path
+          in: path
+          description: Path to the model within the package
+          required: true
           schema:
-            $ref: "#/components/schemas/VersionIdPattern"
+            $ref: "#/components/schemas/PathPattern"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/QueryRequest"
       responses:
         "200":
-          description: A list of models in the package
+          description: Query execution results
           content:
-            application/json:
+            "application/json":
               schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Notebook"
+                $ref: "#/components/schemas/QueryResult"
+        "400":
+          $ref: "#/components/responses/BadRequest"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -1130,17 +1115,17 @@ paths:
           $ref: "#/components/responses/InternalServerError"
         "501":
           $ref: "#/components/responses/NotImplemented"
-
-  /projects/{projectName}/packages/{packageName}/notebooks/{path}:
+  
+  /projects/{projectName}/packages/{packageName}/notebooks:
     get:
       tags:
         - notebooks
-      operationId: get-notebook
-      summary: Get compiled Malloy notebook
+      operationId: list-notebooks
+      summary: List package notebooks
       description: |
-        Retrieves a compiled Malloy notebook with its cells, results, and metadata. The notebook
-        is compiled using the specified version of the Malloy compiler. This endpoint provides
-        access to the notebook's structure, cells, and execution results for use in applications.
+        Retrieves a list of all Malloy notebooks within the specified package. Each notebook entry
+        includes the relative path, package name, and any compilation errors. This endpoint
+        is useful for discovering available notebooks and checking their status.
       parameters:
         - name: projectName
           in: path
@@ -1153,13 +1138,7 @@ paths:
           description: Name of the package
           required: true
           schema:
-            type: string
-        - name: path
-          in: path
-          description: Path to notebook within the package.
-          required: true
-          schema:
-            type: string
+            $ref: "#/components/schemas/IdentifierPattern"
         - name: versionId
           in: query
           description: Version identifier for the package
@@ -1168,11 +1147,13 @@ paths:
             $ref: "#/components/schemas/VersionIdPattern"
       responses:
         "200":
-          description: A Malloy notebook.
+          description: A list of models in the package
           content:
-            "application/json":
+            application/json:
               schema:
-                $ref: "#/components/schemas/CompiledNotebook"
+                type: array
+                items:
+                  $ref: "#/components/schemas/Notebook"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -1182,17 +1163,18 @@ paths:
         "501":
           $ref: "#/components/responses/NotImplemented"
 
-  /projects/{projectName}/packages/{packageName}/queryResults/{path}:
+  # TODO: Notebooks should return the notebook file content, not the compiled notebook.  The front end shoould
+  # run the individual notebook cells against the backend.
+  /projects/{projectName}/packages/{packageName}/notebooks/{path}:
     get:
       tags:
-        - queryresults
-      operationId: execute-query
-      summary: Execute Malloy query
+        - notebooks
+      operationId: get-notebook
+      summary: Get compiled Malloy notebook
       description: |
-        Executes a Malloy query against a model and returns the results. The query can be specified
-        as a raw Malloy query string or by referencing a named query within the model. This endpoint
-        supports both ad-hoc queries and predefined model queries, making it flexible for various
-        use cases including data exploration, reporting, and application integration.
+        Retrieves a compiled Malloy notebook with its cells, results, and metadata. The notebook
+        is compiled using the specified version of the Malloy compiler. This endpoint provides
+        access to the notebook's structure, cells, and execution results for use in applications.
       parameters:
         - name: projectName
           in: path
@@ -1205,46 +1187,26 @@ paths:
           description: Name of the package
           required: true
           schema:
-            $ref: "#/components/schemas/IdentifierPattern"
+            type: string
         - name: path
           in: path
-          description: Path to the model within the package
+          description: Path to notebook within the package.
           required: true
-          schema:
-            $ref: "#/components/schemas/PathPattern"
-        - in: query
-          name: query
-          description: Query string to execute on the model. If the query parameter is set, the queryName parameter must be empty.
-          required: false
-          schema:
-            type: string
-        - in: query
-          name: sourceName
-          description: Name of the source in the model to use for queryName, search, and topValue requests.
-          required: false
-          schema:
-            type: string
-        - in: query
-          name: queryName
-          description: Name of a query to execute on a source in the model. Requires the sourceName parameter is set. If the queryName parameter is set, the query parameter must be empty.
-          required: false
           schema:
             type: string
-        - in: query
-          name: versionId
-          description: Version ID
+        - name: versionId
+          in: query
+          description: Version identifier for the package
           required: false
           schema:
-            type: string
+            $ref: "#/components/schemas/VersionIdPattern"
       responses:
         "200":
-          description: Query execution results
+          description: A Malloy notebook.
           content:
             "application/json":
               schema:
-                $ref: "#/components/schemas/QueryResult"
-        "400":
-          $ref: "#/components/responses/BadRequest"
+                $ref: "#/components/schemas/CompiledNotebook"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
@@ -1254,6 +1216,7 @@ paths:
         "501":
           $ref: "#/components/responses/NotImplemented"
 
+
   /projects/{projectName}/packages/{packageName}/databases:
     get:
       tags:
@@ -1301,52 +1264,38 @@ paths:
         "501":
           $ref: "#/components/responses/NotImplemented"
 
-  /projects/{projectName}/packages/{packageName}/schedules:
-    get:
+  /connections/test:
+    post:
       tags:
-        - schedules
-      operationId: list-schedules
-      summary: List package schedules
+        - connectionsTest
+      operationId: test-connection-configuration
+      summary: Test database connection configuration
       description: |
-        Retrieves a list of all scheduled tasks associated with the specified package. These
-        schedules define automated operations such as data refresh, report generation, or other
-        recurring tasks. Each schedule includes timing information and execution status.
-      parameters:
-        - name: projectName
-          in: path
-          description: Name of the project
-          required: true
-          schema:
-            $ref: "#/components/schemas/IdentifierPattern"
-        - name: packageName
-          in: path
-          description: Name of the package
-          required: true
-          schema:
-            $ref: "#/components/schemas/IdentifierPattern"
-        - name: versionId
-          in: query
-          description: Version identifier for the package
-          required: false
-          schema:
-            $ref: "#/components/schemas/VersionIdPattern"
+        Validates a database connection configuration without adding it to any project.
+        This endpoint allows you to test connection parameters, credentials, and network
+        connectivity before committing the connection to a project. Useful for troubleshooting
+        connection issues and validating configurations during setup.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Connection'
       responses:
         "200":
-          description: A list of scheduled tasks
+          description: Connection test result
           content:
             application/json:
               schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/Schedule"
+                $ref: '#/components/schemas/ConnectionStatus'
+        "400":
+          $ref: "#/components/responses/BadRequest"
         "401":
           $ref: "#/components/responses/Unauthorized"
         "404":
           $ref: "#/components/responses/NotFound"
         "500":
           $ref: "#/components/responses/InternalServerError"
-        "501":
-          $ref: "#/components/responses/NotImplemented"
 
   /watch-mode/status:
     get:
@@ -1648,6 +1597,23 @@ components:
           items:
             type: string
 
+    QueryRequest:
+      type: object
+      description: Request body for executing a Malloy query
+      properties:
+        query:
+          type: string
+          description: Query string to execute on the model. If the query parameter is set, the queryName parameter must be empty.
+        sourceName:
+          type: string
+          description: Name of the source in the model to use for queryName, search, and topValue requests.
+        queryName:
+          type: string
+          description: Name of a query to execute on a source in the model. Requires the sourceName parameter is set. If the queryName parameter is set, the query parameter must be empty.
+        versionId:
+          type: string
+          description: Version ID
+
     NotebookCell:
       type: object
       description: Individual cell within a Malloy notebook
@@ -1696,30 +1662,7 @@ components:
           description: Type of embedded database
           enum: ["embedded", "materialized"]
 
-    Schedule:
-      type: object
-      description: Scheduled task configuration and status
-      properties:
-        resource:
-          type: string
-          description: Resource path in the package that the schedule is attached to
-        schedule:
-          type: string
-          description: Schedule expression in cron format for executing the task
-        action:
-          type: string
-          description: Action to execute when the schedule triggers
-        connection:
-          type: string
-          description: Name of the connection to perform the action on
-        lastRunTime:
-          type: number
-          description: Unix timestamp in milliseconds of the last execution
-        lastRunStatus:
-          type: string
-          description: Status of the last execution
-
-    SchemaName:
+    Schema:
       description: A schema name in a Connection.
       type: object
       properties:
@@ -1749,7 +1692,7 @@ components:
         type:
           type: string
           description: Type of database connection
-          enum: [postgres, bigquery, snowflake, trino, mysql]
+          enum: [postgres, bigquery, snowflake, trino, mysql, duckdb]
         attributes:
           $ref: "#/components/schemas/ConnectionAttributes"
         postgresConnection:
@@ -1762,6 +1705,8 @@ components:
           $ref: "#/components/schemas/TrinoConnection"
         mysqlConnection:
           $ref: "#/components/schemas/MysqlConnection"
+        duckdbConnection:
+          $ref: "#/components/schemas/DuckdbConnection"
 
     ConnectionAttributes:
       type: object
@@ -1898,6 +1843,36 @@ components:
           type: string
           description: Trino password for authentication
 
+    DuckdbConnection:
+      type: object
+      description: DuckDB database connection configuration
+      properties:
+        attachedDatabases:
+          array:
+            $ref: "#/components/schemas/AttachedDatabase"
+
+    AttachedDatabase:
+      type: object
+      description: Attached DuckDB database
+      properties:
+        name:
+          type: string
+          description: Name of the connection
+        type:
+          type: string
+          description: Type of database connection
+          enum: [bigquery, snowflake, postgres]
+        attributes:
+          $ref: "#/components/schemas/ConnectionAttributes"
+        bigqueryConnection:
+          $ref: "#/components/schemas/BigqueryConnection"
+        snowflakeConnection:
+          $ref: "#/components/schemas/SnowflakeConnection"
+        postgresConnection:
+          $ref: "#/components/schemas/PostgresConnection"
+
+
+    # TODO: What is this?  Can we remove it?
     SqlSource:
       type: object
       properties:
@@ -1908,8 +1883,22 @@ components:
         source:
           type: string
 
+    Table:
+      type: object
+      properties:
+        resource:
+          type: string
+          description: Resource path to the table.
+        columns:
+          description: Table fields
+          type: array
+          items:
+            $ref: "#/components/schemas/Column"
+
+    # TODO: Remove this. Replaced by Table
     TableSource:
       type: object
+      deprecated: true
       properties:
         resource:
           type: string