@epilot/kanban-client 1.2.0 → 1.4.0

package/dist/openapi.d.ts

@@ -1,5 +1,3 @@
-/* eslint-disable */
-
 import type {
   OpenAPIClient,
   Parameters,
@@ -10,6 +8,9 @@ import type {
 
 declare namespace Components {
     namespace Schemas {
+        /**
+         * Full representation of a Kanban board, including swimlane layout, filter configuration, card display fields, and sorting options.
+         */
         export interface Board {
             id?: string;
             /**
@@ -39,12 +40,13 @@ declare namespace Components {
                  * workflow_tasks_overview
                  */
                 dataset?: string;
-                swimlanes?: Swimlane[];
+                swimlanes?: /* A vertical column in a Kanban board that groups workflow tasks or entities matching its filter criteria. Each swimlane has an independent filter and a display position. */ Swimlane[];
                 card_config?: {
                     fields?: string[];
                 };
-                board_filter?: BoardFilter;
-                sorting?: Sorting;
+                board_filter?: /* A filter group containing one or more filter items or nested filter groups. Items are combined using the specified logical operator (AND/OR). */ BoardFilter;
+                sorting?: /* Defines how query results should be sorted. Specify a field name and sort direction. */ Sorting;
+                group_by?: /* Defines how tasks should be grouped within each swimlane. Tasks with the same group value are returned adjacently in the result set. */ GroupBy;
                 /**
                  * example:
                  * task 1
@@ -52,6 +54,9 @@ declare namespace Components {
                 search_query?: string;
             };
         }
+        /**
+         * A filter group containing one or more filter items or nested filter groups. Items are combined using the specified logical operator (AND/OR).
+         */
         export interface BoardFilter {
             items: (FilterItem | FilterGroup)[];
             /**
@@ -60,6 +65,9 @@ declare namespace Components {
              */
             combination: "AND" | "OR";
         }
+        /**
+         * Summary representation of a Kanban board, returned in list responses. Does not include swimlane and filter configuration details.
+         */
         export interface BoardSummary {
             id?: string;
             /**
@@ -87,7 +95,24 @@ declare namespace Components {
         /**
          * Dynamic date keywords that resolve to actual dates at runtime
          */
-        export type DynamicDateValue = "TODAY" | "TOMORROW" | "YESTERDAY" | "IN_THE_FUTURE" | "IN_THE_PAST" | "THIS_WEEK" | "NEXT_WEEK" | "LAST_WEEK" | "THIS_MONTH" | "NEXT_MONTH" | "LAST_MONTH";
+        export type DynamicDateValue = "TODAY" | "TOMORROW" | "YESTERDAY" | "IN_THE_FUTURE" | "IN_THE_PAST" | "THIS_WEEK" | "NEXT_WEEK" | "LAST_WEEK" | "THIS_MONTH" | "NEXT_MONTH" | "LAST_MONTH" | "TODAY_OR_EARLIER";
+        /**
+         * Standard error response
+         */
+        export interface Error {
+            /**
+             * Human-readable error message
+             * example:
+             * Board not found
+             */
+            message?: string;
+            /**
+             * HTTP status code
+             * example:
+             * 404
+             */
+            status?: number;
+        }
         export interface FilterGroup {
             items: FilterItem[];
             /**
@@ -123,22 +148,83 @@ declare namespace Components {
          * EQUALS
          */
         export type FilterOperator = "EQUALS" | "NOT_EQUALS" | "EMPTY" | "NOT_EMPTY" | "CONTAINS" | "NOT_CONTAINS" | "IS_ONE_OF" | "IS_NONE_OF" | "GREATER_THAN" | "LESS_THAN" | "GREATER_THAN_OR_EQUAL" | "LESS_THAN_OR_EQUAL";
+        /**
+         * Request payload for executing a query against the Flows dataset. Supports filter conditions, sorting, grouping, and offset-based pagination.
+         */
         export interface FlowsQueryRequest {
-            filters?: BoardFilter;
-            sorting?: Sorting;
+            /**
+             * Optional filter conditions to narrow the result set using AND/OR logic.
+             */
+            filters?: /* A filter group containing one or more filter items or nested filter groups. Items are combined using the specified logical operator (AND/OR). */ BoardFilter;
+            /**
+             * Sort the results by a specific field and direction.
+             */
+            sorting?: /* Defines how query results should be sorted. Specify a field name and sort direction. */ Sorting;
+            /**
+             * Group tasks by a shared property within each swimlane. Grouped tasks are returned adjacently in the result set.
+             */
+            group_by?: /* Defines how tasks should be grouped within each swimlane. Tasks with the same group value are returned adjacently in the result set. */ GroupBy;
+            /**
+             * Zero-based offset for pagination. Use with `size` to paginate through results.
+             * example:
+             * 0
+             */
             from?: number;
+            /**
+             * Number of results to return per page.
+             * example:
+             * 10
+             */
             size?: number;
         }
+        /**
+         * Paginated result set returned from a Flows query. Each item in `results` is a workflow task record with dynamic fields depending on the dataset configuration.
+         */
         export interface FlowsQueryResult {
             [name: string]: any;
+            /**
+             * Array of matching workflow task records. Fields vary based on the dataset and card configuration.
+             */
             results?: {
                 [name: string]: any;
             }[];
+            /**
+             * Total number of records matching the query (across all pages).
+             * example:
+             * 42
+             */
             hits?: number;
+            /**
+             * Current page number (1-based).
+             * example:
+             * 1
+             */
             page_number?: number;
+            /**
+             * Number of results per page (matches the `size` request parameter).
+             * example:
+             * 10
+             */
             page_size?: number;
+            /**
+             * Total number of available pages based on `hits` and `page_size`.
+             * example:
+             * 5
+             */
             total_pages?: number;
         }
+        /**
+         * Defines how tasks should be grouped within each swimlane. Tasks with the same group value are returned adjacently in the result set.
+         */
+        export interface GroupBy {
+            /**
+             * Property to group tasks by within each swimlane
+             */
+            field: "context_entity" | "phase";
+        }
+        /**
+         * Defines how query results should be sorted. Specify a field name and sort direction.
+         */
         export interface Sorting {
             /**
              * example:
@@ -147,6 +233,9 @@ declare namespace Components {
             field: string;
             direction?: "asc" | "desc";
         }
+        /**
+         * A vertical column in a Kanban board that groups workflow tasks or entities matching its filter criteria. Each swimlane has an independent filter and a display position.
+         */
         export interface Swimlane {
             id?: string;
             /**
@@ -159,7 +248,7 @@ declare namespace Components {
              * 1
              */
             position?: number;
-            filter?: BoardFilter;
+            filter?: /* A filter group containing one or more filter items or nested filter groups. Items are combined using the specified logical operator (AND/OR). */ BoardFilter;
             /**
              * example:
              * success
@@ -179,26 +268,19 @@ declare namespace Paths {
                 message?: string;
                 default_board_id?: string | null;
             }
-            export interface $401 {
-            }
-            export interface $403 {
-            }
-            export interface $500 {
-            }
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace CreateKanbanBoard {
-        export type RequestBody = Components.Schemas.Board;
+        export type RequestBody = /* Full representation of a Kanban board, including swimlane layout, filter configuration, card display fields, and sorting options. */ Components.Schemas.Board;
         namespace Responses {
-            export type $200 = Components.Schemas.Board;
-            export interface $400 {
-            }
-            export interface $401 {
-            }
-            export interface $403 {
-            }
-            export interface $500 {
-            }
+            export type $200 = /* Full representation of a Kanban board, including swimlane layout, filter configuration, card display fields, and sorting options. */ Components.Schemas.Board;
+            export type $400 = /* Standard error response */ Components.Schemas.Error;
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace DeleteKanbanBoard {
@@ -211,20 +293,20 @@ declare namespace Paths {
         namespace Responses {
             export interface $200 {
             }
-            export interface $401 {
-            }
-            export interface $403 {
-            }
-            export interface $404 {
-            }
-            export interface $500 {
-            }
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $404 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace ExecuteFlowsQuery {
-        export type RequestBody = Components.Schemas.FlowsQueryRequest;
+        export type RequestBody = /* Request payload for executing a query against the Flows dataset. Supports filter conditions, sorting, grouping, and offset-based pagination. */ Components.Schemas.FlowsQueryRequest;
         namespace Responses {
-            export type $200 = Components.Schemas.FlowsQueryResult;
+            export type $200 = /* Paginated result set returned from a Flows query. Each item in `results` is a workflow task record with dynamic fields depending on the dataset configuration. */ Components.Schemas.FlowsQueryResult;
+            export type $400 = /* Standard error response */ Components.Schemas.Error;
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace FlowsAutocomplete {
@@ -266,6 +348,10 @@ declare namespace Paths {
                  */
                 hits: number;
             }
+            export type $400 = /* Standard error response */ Components.Schemas.Error;
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace GetKanbanBoard {
@@ -276,15 +362,11 @@ declare namespace Paths {
             boardId: Parameters.BoardId;
         }
         namespace Responses {
-            export type $200 = Components.Schemas.Board;
-            export interface $401 {
-            }
-            export interface $403 {
-            }
-            export interface $404 {
-            }
-            export interface $500 {
-            }
+            export type $200 = /* Full representation of a Kanban board, including swimlane layout, filter configuration, card display fields, and sorting options. */ Components.Schemas.Board;
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $404 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace GetKanbanBoards {
@@ -295,13 +377,10 @@ declare namespace Paths {
             filter?: Parameters.Filter;
         }
         namespace Responses {
-            export type $200 = Components.Schemas.BoardSummary[];
-            export interface $401 {
-            }
-            export interface $403 {
-            }
-            export interface $500 {
-            }
+            export type $200 = /* Summary representation of a Kanban board, returned in list responses. Does not include swimlane and filter configuration details. */ Components.Schemas.BoardSummary[];
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace PatchKanbanBoard {
@@ -322,7 +401,13 @@ declare namespace Paths {
              * Board description
              */
             description?: string;
+            /**
+             * Array of user IDs to share the board with
+             */
             shared_with?: string[];
+            /**
+             * Whether the board is shared with the entire organization
+             */
             shared_with_org?: boolean;
             /**
              * Array of user IDs who have full ownership rights for this board (view, edit, delete)
@@ -330,17 +415,12 @@ declare namespace Paths {
             owners?: string[];
         }
         namespace Responses {
-            export type $200 = Components.Schemas.Board;
-            export interface $400 {
-            }
-            export interface $401 {
-            }
-            export interface $403 {
-            }
-            export interface $404 {
-            }
-            export interface $500 {
-            }
+            export type $200 = /* Full representation of a Kanban board, including swimlane layout, filter configuration, card display fields, and sorting options. */ Components.Schemas.Board;
+            export type $400 = /* Standard error response */ Components.Schemas.Error;
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $404 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace SetDefaultKanbanBoard {
@@ -355,16 +435,11 @@ declare namespace Paths {
                 message?: string;
                 default_board_id?: string;
             }
-            export interface $400 {
-            }
-            export interface $401 {
-            }
-            export interface $403 {
-            }
-            export interface $404 {
-            }
-            export interface $500 {
-            }
+            export type $400 = /* Standard error response */ Components.Schemas.Error;
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $404 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
     namespace UpdateKanbanBoard {
@@ -374,19 +449,14 @@ declare namespace Paths {
         export interface PathParameters {
             boardId: Parameters.BoardId;
         }
-        export type RequestBody = Components.Schemas.Board;
+        export type RequestBody = /* Full representation of a Kanban board, including swimlane layout, filter configuration, card display fields, and sorting options. */ Components.Schemas.Board;
         namespace Responses {
-            export type $200 = Components.Schemas.Board;
-            export interface $400 {
-            }
-            export interface $401 {
-            }
-            export interface $403 {
-            }
-            export interface $404 {
-            }
-            export interface $500 {
-            }
+            export type $200 = /* Full representation of a Kanban board, including swimlane layout, filter configuration, card display fields, and sorting options. */ Components.Schemas.Board;
+            export type $400 = /* Standard error response */ Components.Schemas.Error;
+            export type $401 = /* Standard error response */ Components.Schemas.Error;
+            export type $403 = /* Standard error response */ Components.Schemas.Error;
+            export type $404 = /* Standard error response */ Components.Schemas.Error;
+            export type $500 = /* Standard error response */ Components.Schemas.Error;
         }
     }
 }
@@ -394,9 +464,12 @@ declare namespace Paths {
 
 export interface OperationMethods {
   /**
-   * createKanbanBoard - Create a Kanban board
+   * createKanbanBoard - createKanbanBoard
+   * 
+   * Creates a new Kanban board with the provided configuration.
+   * 
+   * A board must have a title and a config containing at least one dataset. Swimlanes and filters can be configured to display specific subsets of workflow tasks or entities.
    * 
-   * Create a Kanban board
    */
   'createKanbanBoard'(
     parameters?: Parameters<UnknownParamsObject> | null,
@@ -404,9 +477,12 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.CreateKanbanBoard.Responses.$200>
   /**
-   * getKanbanBoards - Get all Kanban boards
+   * getKanbanBoards - getKanbanBoards
+   * 
+   * Returns a list of all Kanban boards accessible to the authenticated user.
+   * 
+   * Use the `filter` query parameter to narrow results to boards the user owns (`owned`) or boards shared with them (`shared`). When omitted, all accessible boards are returned.
    * 
-   * Get all Kanban boards
    */
   'getKanbanBoards'(
     parameters?: Parameters<Paths.GetKanbanBoards.QueryParameters> | null,
@@ -414,9 +490,11 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetKanbanBoards.Responses.$200>
   /**
-   * getKanbanBoard - Get a Kanban board
+   * getKanbanBoard - getKanbanBoard
+   * 
+   * Retrieves a Kanban board by ID, including its full configuration (swimlanes, filters, sorting, card fields).
    * 
-   * Get a Kanban board by ID. Use "default" as the boardId to get the organization's default board.
+   * Use `"default"` as the `boardId` to retrieve the organization's currently configured default board.
    * 
    */
   'getKanbanBoard'(
@@ -425,9 +503,12 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetKanbanBoard.Responses.$200>
   /**
-   * updateKanbanBoard - Update a Kanban board
+   * updateKanbanBoard - updateKanbanBoard
+   * 
+   * Fully replaces the configuration of an existing Kanban board by ID.
+   * 
+   * All board fields (title, config, swimlanes, filters) must be provided. Use PATCH for partial updates.
    * 
-   * Update a Kanban board
    */
   'updateKanbanBoard'(
     parameters?: Parameters<Paths.UpdateKanbanBoard.PathParameters> | null,
@@ -435,9 +516,12 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UpdateKanbanBoard.Responses.$200>
   /**
-   * patchKanbanBoard - Patch a Kanban board
+   * patchKanbanBoard - patchKanbanBoard
+   * 
+   * Partially updates fields of an existing Kanban board by ID.
+   * 
+   * Only the fields provided in the request body will be updated. Useful for updating sharing settings, ownership, or title without replacing the full board configuration.
    * 
-   * Patch a Kanban board
    */
   'patchKanbanBoard'(
     parameters?: Parameters<Paths.PatchKanbanBoard.PathParameters> | null,
@@ -445,9 +529,9 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.PatchKanbanBoard.Responses.$200>
   /**
-   * deleteKanbanBoard - Delete a Kanban board
+   * deleteKanbanBoard - deleteKanbanBoard
    * 
-   * Delete a Kanban board
+   * Permanently deletes a Kanban board by ID. This action is irreversible.
    */
   'deleteKanbanBoard'(
     parameters?: Parameters<Paths.DeleteKanbanBoard.PathParameters> | null,
@@ -455,9 +539,13 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DeleteKanbanBoard.Responses.$200>
   /**
-   * setDefaultKanbanBoard - Set default board for organization
+   * setDefaultKanbanBoard - setDefaultKanbanBoard
+   * 
+   * Sets a Kanban board as the default board for the organization.
+   * 
+   * The default board is shown to users who access the Kanban view without specifying a specific board ID.
+   * Pass `boardId` as a query parameter to identify the board to set as default.
    * 
-   * Set a board as the default board for the organization
    */
   'setDefaultKanbanBoard'(
     parameters?: Parameters<Paths.SetDefaultKanbanBoard.QueryParameters> | null,
@@ -465,9 +553,12 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.SetDefaultKanbanBoard.Responses.$200>
   /**
-   * clearDefaultKanbanBoard - Clear default board for organization
+   * clearDefaultKanbanBoard - clearDefaultKanbanBoard
+   * 
+   * Removes the default board configuration for the organization.
+   * 
+   * After calling this endpoint, `getKanbanBoard` with `boardId=default` will return a 404 until a new default is set.
    * 
-   * Remove the default board setting for the organization
    */
   'clearDefaultKanbanBoard'(
     parameters?: Parameters<UnknownParamsObject> | null,
@@ -477,7 +568,11 @@ export interface OperationMethods {
   /**
    * flowsAutocomplete - flowsAutocomplete
    * 
-   * Autocomplete flows data
+   * Returns autocomplete suggestions for a given attribute in the Flows dataset.
+   * 
+   * Use this endpoint to power filter dropdowns and search inputs in the Kanban board configuration UI.
+   * The `attribute` parameter specifies which field to autocomplete (e.g. `name`, `assignee`, `status`).
+   * The optional `input` parameter filters results to those matching the typed prefix.
    * 
    */
   'flowsAutocomplete'(
@@ -488,7 +583,11 @@ export interface OperationMethods {
   /**
    * executeFlowsQuery - executeFlowsQuery
    * 
-   * Query Flows Data for Kanban View.
+   * Executes a query against the Flows dataset and returns paginated results for use in Kanban card rendering.
+   * 
+   * Supports filtering with complex AND/OR logic, sorting, and offset-based pagination.
+   * Results are used to populate Kanban swimlane cards with real-time workflow task data.
+   * 
    */
   'executeFlowsQuery'(
     parameters?: Parameters<UnknownParamsObject> | null,
@@ -500,9 +599,12 @@ export interface OperationMethods {
 export interface PathsDictionary {
   ['/v1/kanban/board']: {
     /**
-     * createKanbanBoard - Create a Kanban board
+     * createKanbanBoard - createKanbanBoard
+     * 
+     * Creates a new Kanban board with the provided configuration.
+     * 
+     * A board must have a title and a config containing at least one dataset. Swimlanes and filters can be configured to display specific subsets of workflow tasks or entities.
      * 
-     * Create a Kanban board
      */
     'post'(
       parameters?: Parameters<UnknownParamsObject> | null,
@@ -512,9 +614,12 @@ export interface PathsDictionary {
   }
   ['/v1/kanban/boards']: {
     /**
-     * getKanbanBoards - Get all Kanban boards
+     * getKanbanBoards - getKanbanBoards
+     * 
+     * Returns a list of all Kanban boards accessible to the authenticated user.
+     * 
+     * Use the `filter` query parameter to narrow results to boards the user owns (`owned`) or boards shared with them (`shared`). When omitted, all accessible boards are returned.
      * 
-     * Get all Kanban boards
      */
     'get'(
       parameters?: Parameters<Paths.GetKanbanBoards.QueryParameters> | null,
@@ -524,9 +629,11 @@ export interface PathsDictionary {
   }
   ['/v1/kanban/board/{boardId}']: {
     /**
-     * getKanbanBoard - Get a Kanban board
+     * getKanbanBoard - getKanbanBoard
+     * 
+     * Retrieves a Kanban board by ID, including its full configuration (swimlanes, filters, sorting, card fields).
      * 
-     * Get a Kanban board by ID. Use "default" as the boardId to get the organization's default board.
+     * Use `"default"` as the `boardId` to retrieve the organization's currently configured default board.
      * 
      */
     'get'(
@@ -535,9 +642,12 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetKanbanBoard.Responses.$200>
     /**
-     * updateKanbanBoard - Update a Kanban board
+     * updateKanbanBoard - updateKanbanBoard
+     * 
+     * Fully replaces the configuration of an existing Kanban board by ID.
+     * 
+     * All board fields (title, config, swimlanes, filters) must be provided. Use PATCH for partial updates.
      * 
-     * Update a Kanban board
      */
     'put'(
       parameters?: Parameters<Paths.UpdateKanbanBoard.PathParameters> | null,
@@ -545,9 +655,12 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.UpdateKanbanBoard.Responses.$200>
     /**
-     * patchKanbanBoard - Patch a Kanban board
+     * patchKanbanBoard - patchKanbanBoard
+     * 
+     * Partially updates fields of an existing Kanban board by ID.
+     * 
+     * Only the fields provided in the request body will be updated. Useful for updating sharing settings, ownership, or title without replacing the full board configuration.
      * 
-     * Patch a Kanban board
      */
     'patch'(
       parameters?: Parameters<Paths.PatchKanbanBoard.PathParameters> | null,
@@ -555,9 +668,9 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.PatchKanbanBoard.Responses.$200>
     /**
-     * deleteKanbanBoard - Delete a Kanban board
+     * deleteKanbanBoard - deleteKanbanBoard
      * 
-     * Delete a Kanban board
+     * Permanently deletes a Kanban board by ID. This action is irreversible.
      */
     'delete'(
       parameters?: Parameters<Paths.DeleteKanbanBoard.PathParameters> | null,
@@ -567,9 +680,13 @@ export interface PathsDictionary {
   }
   ['/v1/kanban/org/default-board']: {
     /**
-     * setDefaultKanbanBoard - Set default board for organization
+     * setDefaultKanbanBoard - setDefaultKanbanBoard
+     * 
+     * Sets a Kanban board as the default board for the organization.
+     * 
+     * The default board is shown to users who access the Kanban view without specifying a specific board ID.
+     * Pass `boardId` as a query parameter to identify the board to set as default.
      * 
-     * Set a board as the default board for the organization
      */
     'put'(
       parameters?: Parameters<Paths.SetDefaultKanbanBoard.QueryParameters> | null,
@@ -577,9 +694,12 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.SetDefaultKanbanBoard.Responses.$200>
     /**
-     * clearDefaultKanbanBoard - Clear default board for organization
+     * clearDefaultKanbanBoard - clearDefaultKanbanBoard
+     * 
+     * Removes the default board configuration for the organization.
+     * 
+     * After calling this endpoint, `getKanbanBoard` with `boardId=default` will return a 404 until a new default is set.
      * 
-     * Remove the default board setting for the organization
      */
     'delete'(
       parameters?: Parameters<UnknownParamsObject> | null,
@@ -591,7 +711,11 @@ export interface PathsDictionary {
     /**
      * flowsAutocomplete - flowsAutocomplete
      * 
-     * Autocomplete flows data
+     * Returns autocomplete suggestions for a given attribute in the Flows dataset.
+     * 
+     * Use this endpoint to power filter dropdowns and search inputs in the Kanban board configuration UI.
+     * The `attribute` parameter specifies which field to autocomplete (e.g. `name`, `assignee`, `status`).
+     * The optional `input` parameter filters results to those matching the typed prefix.
      * 
      */
     'get'(
@@ -604,7 +728,11 @@ export interface PathsDictionary {
     /**
      * executeFlowsQuery - executeFlowsQuery
      * 
-     * Query Flows Data for Kanban View.
+     * Executes a query against the Flows dataset and returns paginated results for use in Kanban card rendering.
+     * 
+     * Supports filtering with complex AND/OR logic, sorting, and offset-based pagination.
+     * Results are used to populate Kanban swimlane cards with real-time workflow task data.
+     * 
      */
     'post'(
       parameters?: Parameters<UnknownParamsObject> | null,
@@ -621,11 +749,13 @@ export type Board = Components.Schemas.Board;
 export type BoardFilter = Components.Schemas.BoardFilter;
 export type BoardSummary = Components.Schemas.BoardSummary;
 export type DynamicDateValue = Components.Schemas.DynamicDateValue;
+export type Error = Components.Schemas.Error;
 export type FilterGroup = Components.Schemas.FilterGroup;
 export type FilterItem = Components.Schemas.FilterItem;
 export type FilterOperator = Components.Schemas.FilterOperator;
 export type FlowsQueryRequest = Components.Schemas.FlowsQueryRequest;
 export type FlowsQueryResult = Components.Schemas.FlowsQueryResult;
+export type GroupBy = Components.Schemas.GroupBy;
 export type Sorting = Components.Schemas.Sorting;
 export type Swimlane = Components.Schemas.Swimlane;
 export type ValueType = Components.Schemas.ValueType;