@algolia/ingestion 1.0.0-alpha.82 → 1.0.0-alpha.84

package/dist/ingestion.cjs

@@ -4,7 +4,7 @@ var clientCommon = require('@algolia/client-common');
 var requesterNodeHttp = require('@algolia/requester-node-http');
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
-const apiClientVersion = '1.0.0-alpha.82';
+const apiClientVersion = '1.0.0-alpha.84';
 const REGIONS = ['eu', 'us'];
 function getDefaultHosts(region) {
     const url = 'data.{region}.algolia.com'.replace('{region}', region);
@@ -89,7 +89,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             transporter.algoliaAgent.add({ segment, version });
         },
         /**
-         * Create a authentication.
+         * Creates a new authentication resource.
          *
          * Required API Key ACLs:
          * - addObject
@@ -125,7 +125,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Create a destination.
+         * Creates a new destination.
          *
          * Required API Key ACLs:
          * - addObject
@@ -161,7 +161,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Create a source.
+         * Creates a new source.
          *
          * Required API Key ACLs:
          * - addObject
@@ -197,9 +197,9 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Create a task.
+         * Creates a new task.
          *
-         * @param taskCreate -.
+         * @param taskCreate - Request body for creating a task.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         createTask(taskCreate, requestOptions) {
@@ -242,7 +242,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customDelete`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -265,7 +265,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customGet`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -289,7 +289,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPost`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -314,7 +314,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             if (!path) {
                 throw new Error('Parameter `path` is required when calling `customPut`.');
             }
-            const requestPath = '/1{path}'.replace('{path}', path);
+            const requestPath = '/{path}'.replace('{path}', path);
             const headers = {};
             const queryParameters = parameters ? parameters : {};
             const request = {
@@ -327,7 +327,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Soft delete the authentication of the given authenticationID.
+         * Deletes an authentication resource. You can\'t delete authentication resources that are used by a source or a destination.
          *
          * Required API Key ACLs:
          * - addObject
@@ -335,7 +335,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param deleteAuthentication - The deleteAuthentication object.
-         * @param deleteAuthentication.authenticationID - The authentication UUID.
+         * @param deleteAuthentication.authenticationID - Unique identifier of an authentication resource.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteAuthentication({ authenticationID }, requestOptions) {
@@ -354,7 +354,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Soft delete the destination of the given destinationID.
+         * Deletes a destination by its ID. You can\'t delete destinations that are referenced in tasks.
          *
          * Required API Key ACLs:
          * - addObject
@@ -362,7 +362,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param deleteDestination - The deleteDestination object.
-         * @param deleteDestination.destinationID - The destination UUID.
+         * @param deleteDestination.destinationID - Unique identifier of a destination.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteDestination({ destinationID }, requestOptions) {
@@ -381,7 +381,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Soft delete the source of the given sourceID.
+         * Deletes a source by its ID. You can\'t delete sources that are referenced in tasks.
          *
          * Required API Key ACLs:
          * - addObject
@@ -389,7 +389,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param deleteSource - The deleteSource object.
-         * @param deleteSource.sourceID - The source UUID.
+         * @param deleteSource.sourceID - Unique identifier of a source.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteSource({ sourceID }, requestOptions) {
@@ -408,10 +408,10 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Soft delete the task of the given taskID.
+         * Deletes a task by its ID.
          *
          * @param deleteTask - The deleteTask object.
-         * @param deleteTask.taskID - The task UUID.
+         * @param deleteTask.taskID - Unique identifier of a task.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         deleteTask({ taskID }, requestOptions) {
@@ -430,7 +430,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Disable the task of the given taskID.
+         * Disables a task.
          *
          * Required API Key ACLs:
          * - addObject
@@ -438,7 +438,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param disableTask - The disableTask object.
-         * @param disableTask.taskID - The task UUID.
+         * @param disableTask.taskID - Unique identifier of a task.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         disableTask({ taskID }, requestOptions) {
@@ -457,7 +457,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Enable the task of the given taskID.
+         * Enables a task.
          *
          * Required API Key ACLs:
          * - addObject
@@ -465,7 +465,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param enableTask - The enableTask object.
-         * @param enableTask.taskID - The task UUID.
+         * @param enableTask.taskID - Unique identifier of a task.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         enableTask({ taskID }, requestOptions) {
@@ -484,7 +484,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get the authentication of the given authenticationID.
+         * Retrieves an authentication resource by its ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -492,7 +492,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getAuthentication - The getAuthentication object.
-         * @param getAuthentication.authenticationID - The authentication UUID.
+         * @param getAuthentication.authenticationID - Unique identifier of an authentication resource.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getAuthentication({ authenticationID }, requestOptions) {
@@ -511,7 +511,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a list of authentications for the given query parameters, with pagination details.
+         * Retrieves a list of all authentication resources.
          *
          * Required API Key ACLs:
          * - addObject
@@ -519,12 +519,12 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getAuthentications - The getAuthentications object.
-         * @param getAuthentications.itemsPerPage - The number of items per page to return.
-         * @param getAuthentications.page - The page number to fetch, starting at 1.
-         * @param getAuthentications.type - The type of the authentications to retrieve.
-         * @param getAuthentications.platform - The platform of the authentications to retrieve.
-         * @param getAuthentications.sort - The key by which the list should be sorted.
-         * @param getAuthentications.order - The order of the returned list.
+         * @param getAuthentications.itemsPerPage - Number of items per page.
+         * @param getAuthentications.page - Page number of the paginated API response.
+         * @param getAuthentications.type - Type of authentication resource to retrieve.
+         * @param getAuthentications.platform - Ecommerce platform for which to retrieve authentication resources.
+         * @param getAuthentications.sort - Property by which to sort the list of authentication resources.
+         * @param getAuthentications.order - Sort order of the response, ascending or descending.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getAuthentications({ itemsPerPage, page, type, platform, sort, order, } = {}, requestOptions = undefined) {
@@ -558,7 +558,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get the destination of the given destinationID.
+         * Retrieves a destination by its ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -566,7 +566,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getDestination - The getDestination object.
-         * @param getDestination.destinationID - The destination UUID.
+         * @param getDestination.destinationID - Unique identifier of a destination.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getDestination({ destinationID }, requestOptions) {
@@ -585,7 +585,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a list of destinations for the given query parameters, with pagination details.
+         * Retrieves a list of destinations.
          *
          * Required API Key ACLs:
          * - addObject
@@ -593,12 +593,12 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getDestinations - The getDestinations object.
-         * @param getDestinations.itemsPerPage - The number of items per page to return.
-         * @param getDestinations.page - The page number to fetch, starting at 1.
-         * @param getDestinations.type - The type of the destinations to retrive.
-         * @param getDestinations.authenticationID - The authenticationIDs of the destinations to retrive.
-         * @param getDestinations.sort - The key by which the list should be sorted.
-         * @param getDestinations.order - The order of the returned list.
+         * @param getDestinations.itemsPerPage - Number of items per page.
+         * @param getDestinations.page - Page number of the paginated API response.
+         * @param getDestinations.type - Destination type.
+         * @param getDestinations.authenticationID - Authentication ID used by destinations.
+         * @param getDestinations.sort - Property by which to sort the destinations.
+         * @param getDestinations.order - Sort order of the response, ascending or descending.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getDestinations({ itemsPerPage, page, type, authenticationID, sort, order, } = {}, requestOptions = undefined) {
@@ -632,7 +632,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Retrieve a stream listing for a given Singer specification compatible docker type source ID.
+         * Retrieves a stream listing for a source.  Listing streams only works with sources with `type: docker` and `imageType: singer`.
          *
          * Required API Key ACLs:
          * - addObject
@@ -640,7 +640,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getDockerSourceStreams - The getDockerSourceStreams object.
-         * @param getDockerSourceStreams.sourceID - The source UUID.
+         * @param getDockerSourceStreams.sourceID - Unique identifier of a source.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getDockerSourceStreams({ sourceID }, requestOptions) {
@@ -659,7 +659,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a single event for a specific runID.
+         * Retrieves a single task run event by its ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -667,8 +667,8 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getEvent - The getEvent object.
-         * @param getEvent.runID - The run UUID.
-         * @param getEvent.eventID - The event UUID.
+         * @param getEvent.runID - Unique identifier of a task run.
+         * @param getEvent.eventID - Unique identifier of an event.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getEvent({ runID, eventID }, requestOptions) {
@@ -692,7 +692,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a list of events associated to the given runID, for the given query parameters.
+         * Retrieves a list of events for a task run, identified by it\'s ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -700,15 +700,15 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getEvents - The getEvents object.
-         * @param getEvents.runID - The run UUID.
-         * @param getEvents.itemsPerPage - The number of items per page to return.
-         * @param getEvents.page - The page number to fetch, starting at 1.
-         * @param getEvents.status - Filter the status of the events.
-         * @param getEvents.type - Filter the type of the events.
-         * @param getEvents.sort - The key by which the list should be sorted.
-         * @param getEvents.order - The order of the returned list.
-         * @param getEvents.startDate - The start date (in RFC3339 format) of the events fetching window. Defaults to \'now\'-3 hours if omitted.
-         * @param getEvents.endDate - The end date (in RFC3339 format) of the events fetching window. Defaults to \'now\' days if omitted.
+         * @param getEvents.runID - Unique identifier of a task run.
+         * @param getEvents.itemsPerPage - Number of items per page.
+         * @param getEvents.page - Page number of the paginated API response.
+         * @param getEvents.status - Event status for filtering the list of task runs.
+         * @param getEvents.type - Event type for filtering the list of task runs.
+         * @param getEvents.sort - Property by which to sort the list of task run events.
+         * @param getEvents.order - Sort order of the response, ascending or descending.
+         * @param getEvents.startDate - Date and time in RFC3339 format for the earliest events to retrieve. By default, the current time minus three hours is used.
+         * @param getEvents.endDate - Date and time in RFC3339 format for the latest events to retrieve. By default, the current time is used.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getEvents({ runID, itemsPerPage, page, status, type, sort, order, startDate, endDate, }, requestOptions) {
@@ -751,7 +751,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a single run for the given ID.
+         * Retrieve a single task run by its ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -759,7 +759,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getRun - The getRun object.
-         * @param getRun.runID - The run UUID.
+         * @param getRun.runID - Unique identifier of a task run.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getRun({ runID }, requestOptions) {
@@ -778,7 +778,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a list of runs for the given query parameters, with pagination details.
+         * Retrieve a list of task runs.
          *
          * Required API Key ACLs:
          * - addObject
@@ -786,14 +786,14 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getRuns - The getRuns object.
-         * @param getRuns.itemsPerPage - The number of items per page to return.
-         * @param getRuns.page - The page number to fetch, starting at 1.
-         * @param getRuns.status - Filter the status of the runs.
-         * @param getRuns.taskID - Filter by taskID.
-         * @param getRuns.sort - The key by which the list should be sorted.
-         * @param getRuns.order - The order of the returned list.
-         * @param getRuns.startDate - The start date (in RFC3339 format) of the runs fetching window. Defaults to \'now\'-7 days if omitted.
-         * @param getRuns.endDate - The end date (in RFC3339 format) of the runs fetching window. Defaults to \'now\' days if omitted.
+         * @param getRuns.itemsPerPage - Number of items per page.
+         * @param getRuns.page - Page number of the paginated API response.
+         * @param getRuns.status - Run status for filtering the list of task runs.
+         * @param getRuns.taskID - Task ID for filtering the list of task runs.
+         * @param getRuns.sort - Property by which to sort the list of task runs.
+         * @param getRuns.order - Sort order of the response, ascending or descending.
+         * @param getRuns.startDate - Date in RFC3339 format for the earliest run to retrieve. By default, the current day minus seven days is used.
+         * @param getRuns.endDate - Date in RFC3339 format for the latest run to retrieve. By default, the current day is used.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getRuns({ itemsPerPage, page, status, taskID, sort, order, startDate, endDate, } = {}, requestOptions = undefined) {
@@ -833,7 +833,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get the source of the given sourceID.
+         * Retrieve a source by its ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -841,7 +841,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getSource - The getSource object.
-         * @param getSource.sourceID - The source UUID.
+         * @param getSource.sourceID - Unique identifier of a source.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getSource({ sourceID }, requestOptions) {
@@ -860,7 +860,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a list of sources for the given query parameters, with pagination details.
+         * Retrieves a list of sources.
          *
          * Required API Key ACLs:
          * - addObject
@@ -868,12 +868,12 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getSources - The getSources object.
-         * @param getSources.itemsPerPage - The number of items per page to return.
-         * @param getSources.page - The page number to fetch, starting at 1.
-         * @param getSources.type - The type of the sources to retrieve.
-         * @param getSources.authenticationID - The authenticationIDs of the sources to retrieve. \'none\' returns sources that doesn\'t have an authentication.
-         * @param getSources.sort - The key by which the list should be sorted.
-         * @param getSources.order - The order of the returned list.
+         * @param getSources.itemsPerPage - Number of items per page.
+         * @param getSources.page - Page number of the paginated API response.
+         * @param getSources.type - Source type. Some sources require authentication.
+         * @param getSources.authenticationID - Authentication IDs of the sources to retrieve. \'none\' returns sources that doesn\'t have an authentication resource.
+         * @param getSources.sort - Property by which to sort the list of sources.
+         * @param getSources.order - Sort order of the response, ascending or descending.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getSources({ itemsPerPage, page, type, authenticationID, sort, order, } = {}, requestOptions = undefined) {
@@ -907,7 +907,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get the task of the given taskID.
+         * Retrieves a task by its ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -915,7 +915,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getTask - The getTask object.
-         * @param getTask.taskID - The task UUID.
+         * @param getTask.taskID - Unique identifier of a task.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getTask({ taskID }, requestOptions) {
@@ -934,7 +934,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Get a list of tasks for the given query parameters, with pagination details.
+         * Retrieves a list of tasks.
          *
          * Required API Key ACLs:
          * - addObject
@@ -942,15 +942,15 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param getTasks - The getTasks object.
-         * @param getTasks.itemsPerPage - The number of items per page to return.
-         * @param getTasks.page - The page number to fetch, starting at 1.
-         * @param getTasks.action - The action of the tasks to retrieve.
-         * @param getTasks.enabled - Whether the task is enabled or not.
-         * @param getTasks.sourceID - The sourceIDs of the tasks to retrieve.
-         * @param getTasks.destinationID - The destinationIDs of the tasks to retrieve.
-         * @param getTasks.triggerType - The trigger type of the task.
-         * @param getTasks.sort - The key by which the list should be sorted.
-         * @param getTasks.order - The order of the returned list.
+         * @param getTasks.itemsPerPage - Number of items per page.
+         * @param getTasks.page - Page number of the paginated API response.
+         * @param getTasks.action - Actions for filtering the list of tasks.
+         * @param getTasks.enabled - Whether to filter the list of tasks by the `enabled` status.
+         * @param getTasks.sourceID - Source IDs for filtering the list of tasks.
+         * @param getTasks.destinationID - Destination IDs for filtering the list of tasks.
+         * @param getTasks.triggerType - Type of task trigger for filtering the list of tasks.
+         * @param getTasks.sort - Property by which to sort the list of tasks.
+         * @param getTasks.order - Sort order of the response, ascending or descending.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         getTasks({ itemsPerPage, page, action, enabled, sourceID, destinationID, triggerType, sort, order, } = {}, requestOptions = undefined) {
@@ -993,7 +993,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Run the task of the given taskID.
+         * Runs a task. You can check the status of task runs with the observability endpoints.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1001,7 +1001,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param runTask - The runTask object.
-         * @param runTask.taskID - The task UUID.
+         * @param runTask.taskID - Unique identifier of a task.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         runTask({ taskID }, requestOptions) {
@@ -1020,7 +1020,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Search among authentications with a defined set of parameters.
+         * Searches for authentication resources.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1050,7 +1050,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Search among destinations with a defined set of parameters.
+         * Searches for destinations.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1080,7 +1080,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Search among sources with a defined set of parameters.
+         * Searches for sources.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1110,7 +1110,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Search among tasks with a defined set of parameters.
+         * Searches for tasks.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1140,7 +1140,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Trigger a stream listing request for a Singer specification compatible docker type source.
+         * Triggers a stream-listing request for a source. Triggering stream-listing requests only works with sources with `type: docker` and `imageType: singer`.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1148,7 +1148,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param triggerDockerSourceDiscover - The triggerDockerSourceDiscover object.
-         * @param triggerDockerSourceDiscover.sourceID - The source UUID.
+         * @param triggerDockerSourceDiscover.sourceID - Unique identifier of a source.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
         triggerDockerSourceDiscover({ sourceID }, requestOptions) {
@@ -1167,7 +1167,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Update the authentication of the given authenticationID.
+         * Updates an authentication resource.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1175,7 +1175,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param updateAuthentication - The updateAuthentication object.
-         * @param updateAuthentication.authenticationID - The authentication UUID.
+         * @param updateAuthentication.authenticationID - Unique identifier of an authentication resource.
          * @param updateAuthentication.authenticationUpdate - The authenticationUpdate object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1199,7 +1199,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Update the destination of the given destinationID.
+         * Updates the destination by its ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1207,7 +1207,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param updateDestination - The updateDestination object.
-         * @param updateDestination.destinationID - The destination UUID.
+         * @param updateDestination.destinationID - Unique identifier of a destination.
          * @param updateDestination.destinationUpdate - The destinationUpdate object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1231,7 +1231,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Update the source of the given sourceID.
+         * Updates a source by its ID.
          *
          * Required API Key ACLs:
          * - addObject
@@ -1239,7 +1239,7 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
          * - editSettings.
          *
          * @param updateSource - The updateSource object.
-         * @param updateSource.sourceID - The source UUID.
+         * @param updateSource.sourceID - Unique identifier of a source.
          * @param updateSource.sourceUpdate - The sourceUpdate object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */
@@ -1263,10 +1263,10 @@ function createIngestionClient({ appId: appIdOption, apiKey: apiKeyOption, authM
             return transporter.request(request, requestOptions);
         },
         /**
-         * Update the task of the given taskID.
+         * Updates a task by its ID.
          *
          * @param updateTask - The updateTask object.
-         * @param updateTask.taskID - The task UUID.
+         * @param updateTask.taskID - Unique identifier of a task.
          * @param updateTask.taskUpdate - The taskUpdate object.
          * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
          */