fix(specs): deprecate task v1 [skip-bc] (generated)

algolia/api-clients-automation#4327

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Pierre Millot <[email protected]>

Author: algolia-bot

algoliasearch/Clients/IngestionClient.cs

@@ -157,6 +157,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>Task of TaskCreateResponse</returns>
+  [Obsolete]
   Task<TaskCreateResponse> CreateTaskV1Async(TaskCreateV1 taskCreate, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -169,6 +170,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>TaskCreateResponse</returns>
+  [Obsolete]
   TaskCreateResponse CreateTaskV1(TaskCreateV1 taskCreate, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -439,6 +441,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>Task of DeleteResponse</returns>
+  [Obsolete]
   Task<DeleteResponse> DeleteTaskV1Async(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -451,6 +454,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>DeleteResponse</returns>
+  [Obsolete]
   DeleteResponse DeleteTaskV1(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -596,6 +600,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>Task of TaskUpdateResponse</returns>
+  [Obsolete]
   Task<TaskUpdateResponse> EnableTaskV1Async(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -613,6 +618,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>TaskUpdateResponse</returns>
+  [Obsolete]
   TaskUpdateResponse EnableTaskV1(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -836,6 +842,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>Task of TaskV1</returns>
+  [Obsolete]
   Task<TaskV1> GetTaskV1Async(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -853,6 +860,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>TaskV1</returns>
+  [Obsolete]
   TaskV1 GetTaskV1(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -1200,6 +1208,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>Task of ListTasksResponseV1</returns>
+  [Obsolete]
   Task<ListTasksResponseV1> ListTasksV1Async(int? itemsPerPage = default, int? page = default, List<ActionType> action = default, bool? enabled = default, List<string> sourceID = default, List<string> destinationID = default, List<TriggerType> triggerType = default, TaskSortKeys? sort = default, OrderKeys? order = default, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -1225,6 +1234,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>ListTasksResponseV1</returns>
+  [Obsolete]
   ListTasksResponseV1 ListTasksV1(int? itemsPerPage = default, int? page = default, List<ActionType> action = default, bool? enabled = default, List<string> sourceID = default, List<string> destinationID = default, List<TriggerType> triggerType = default, TaskSortKeys? sort = default, OrderKeys? order = default, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -1390,6 +1400,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>Task of RunResponse</returns>
+  [Obsolete]
   Task<RunResponse> RunTaskV1Async(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -1407,6 +1418,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>RunResponse</returns>
+  [Obsolete]
   RunResponse RunTaskV1(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -1560,6 +1572,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>Task of List{TaskV1}</returns>
+  [Obsolete]
   Task<List<TaskV1>> SearchTasksV1Async(TaskSearch taskSearch, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -1577,6 +1590,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>List{TaskV1}</returns>
+  [Obsolete]
   List<TaskV1> SearchTasksV1(TaskSearch taskSearch, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -1862,6 +1876,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>Task of TaskUpdateResponse</returns>
+  [Obsolete]
   Task<TaskUpdateResponse> UpdateTaskV1Async(string taskID, TaskUpdateV1 taskUpdate, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -1875,6 +1890,7 @@ public interface IIngestionClient
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaApiException">Thrown when the API call was rejected by Algolia</exception>
   /// <exception cref="Algolia.Search.Exceptions.AlgoliaUnreachableHostException">Thrown when the client failed to call the endpoint</exception>
   /// <returns>TaskUpdateResponse</returns>
+  [Obsolete]
   TaskUpdateResponse UpdateTaskV1(string taskID, TaskUpdateV1 taskUpdate, RequestOptions options = null, CancellationToken cancellationToken = default);
 
   /// <summary>
@@ -2133,6 +2149,7 @@ public TaskCreateResponse CreateTask(TaskCreate taskCreate, RequestOptions optio
 
 
   /// <inheritdoc />
+  [Obsolete]
   public async Task<TaskCreateResponse> CreateTaskV1Async(TaskCreateV1 taskCreate, RequestOptions options = null, CancellationToken cancellationToken = default)
   {
 
@@ -2148,6 +2165,7 @@ public async Task<TaskCreateResponse> CreateTaskV1Async(TaskCreateV1 taskCreate,
 
 
   /// <inheritdoc />
+  [Obsolete]
   public TaskCreateResponse CreateTaskV1(TaskCreateV1 taskCreate, RequestOptions options = null, CancellationToken cancellationToken = default) =>
     AsyncHelper.RunSync(() => CreateTaskV1Async(taskCreate, options, cancellationToken));
 
@@ -2335,6 +2353,7 @@ public DeleteResponse DeleteTask(string taskID, RequestOptions options = null, C
 
 
   /// <inheritdoc />
+  [Obsolete]
   public async Task<DeleteResponse> DeleteTaskV1Async(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default)
   {
 
@@ -2350,6 +2369,7 @@ public async Task<DeleteResponse> DeleteTaskV1Async(string taskID, RequestOption
 
 
   /// <inheritdoc />
+  [Obsolete]
   public DeleteResponse DeleteTaskV1(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default) =>
     AsyncHelper.RunSync(() => DeleteTaskV1Async(taskID, options, cancellationToken));
 
@@ -2437,6 +2457,7 @@ public TaskUpdateResponse EnableTask(string taskID, RequestOptions options = nul
 
 
   /// <inheritdoc />
+  [Obsolete]
   public async Task<TaskUpdateResponse> EnableTaskV1Async(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default)
   {
 
@@ -2452,6 +2473,7 @@ public async Task<TaskUpdateResponse> EnableTaskV1Async(string taskID, RequestOp
 
 
   /// <inheritdoc />
+  [Obsolete]
   public TaskUpdateResponse EnableTaskV1(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default) =>
     AsyncHelper.RunSync(() => EnableTaskV1Async(taskID, options, cancellationToken));
 
@@ -2582,6 +2604,7 @@ public IngestionTask GetTask(string taskID, RequestOptions options = null, Cance
 
 
   /// <inheritdoc />
+  [Obsolete]
   public async Task<TaskV1> GetTaskV1Async(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default)
   {
 
@@ -2597,6 +2620,7 @@ public async Task<TaskV1> GetTaskV1Async(string taskID, RequestOptions options =
 
 
   /// <inheritdoc />
+  [Obsolete]
   public TaskV1 GetTaskV1(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default) =>
     AsyncHelper.RunSync(() => GetTaskV1Async(taskID, options, cancellationToken));
 
@@ -2764,6 +2788,7 @@ public ListTasksResponse ListTasks(int? itemsPerPage = default, int? page = defa
 
 
   /// <inheritdoc />
+  [Obsolete]
   public async Task<ListTasksResponseV1> ListTasksV1Async(int? itemsPerPage = default, int? page = default, List<ActionType> action = default, bool? enabled = default, List<string> sourceID = default, List<string> destinationID = default, List<TriggerType> triggerType = default, TaskSortKeys? sort = default, OrderKeys? order = default, RequestOptions options = null, CancellationToken cancellationToken = default)
   {
     var requestOptions = new InternalRequestOptions(options);
@@ -2783,6 +2808,7 @@ public async Task<ListTasksResponseV1> ListTasksV1Async(int? itemsPerPage = defa
 
 
   /// <inheritdoc />
+  [Obsolete]
   public ListTasksResponseV1 ListTasksV1(int? itemsPerPage = default, int? page = default, List<ActionType> action = default, bool? enabled = default, List<string> sourceID = default, List<string> destinationID = default, List<TriggerType> triggerType = default, TaskSortKeys? sort = default, OrderKeys? order = default, RequestOptions options = null, CancellationToken cancellationToken = default) =>
     AsyncHelper.RunSync(() => ListTasksV1Async(itemsPerPage, page, action, enabled, sourceID, destinationID, triggerType, sort, order, options, cancellationToken));
 
@@ -2877,6 +2903,7 @@ public RunResponse RunTask(string taskID, RequestOptions options = null, Cancell
 
 
   /// <inheritdoc />
+  [Obsolete]
   public async Task<RunResponse> RunTaskV1Async(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default)
   {
 
@@ -2892,6 +2919,7 @@ public async Task<RunResponse> RunTaskV1Async(string taskID, RequestOptions opti
 
 
   /// <inheritdoc />
+  [Obsolete]
   public RunResponse RunTaskV1(string taskID, RequestOptions options = null, CancellationToken cancellationToken = default) =>
     AsyncHelper.RunSync(() => RunTaskV1Async(taskID, options, cancellationToken));
 
@@ -2977,6 +3005,7 @@ public List<IngestionTask> SearchTasks(TaskSearch taskSearch, RequestOptions opt
 
 
   /// <inheritdoc />
+  [Obsolete]
   public async Task<List<TaskV1>> SearchTasksV1Async(TaskSearch taskSearch, RequestOptions options = null, CancellationToken cancellationToken = default)
   {
 
@@ -2992,6 +3021,7 @@ public async Task<List<TaskV1>> SearchTasksV1Async(TaskSearch taskSearch, Reques
 
 
   /// <inheritdoc />
+  [Obsolete]
   public List<TaskV1> SearchTasksV1(TaskSearch taskSearch, RequestOptions options = null, CancellationToken cancellationToken = default) =>
     AsyncHelper.RunSync(() => SearchTasksV1Async(taskSearch, options, cancellationToken));
 
@@ -3185,6 +3215,7 @@ public TaskUpdateResponse UpdateTask(string taskID, TaskUpdate taskUpdate, Reque
 
 
   /// <inheritdoc />
+  [Obsolete]
   public async Task<TaskUpdateResponse> UpdateTaskV1Async(string taskID, TaskUpdateV1 taskUpdate, RequestOptions options = null, CancellationToken cancellationToken = default)
   {
 
@@ -3205,6 +3236,7 @@ public async Task<TaskUpdateResponse> UpdateTaskV1Async(string taskID, TaskUpdat
 
 
   /// <inheritdoc />
+  [Obsolete]
   public TaskUpdateResponse UpdateTaskV1(string taskID, TaskUpdateV1 taskUpdate, RequestOptions options = null, CancellationToken cancellationToken = default) =>
     AsyncHelper.RunSync(() => UpdateTaskV1Async(taskID, taskUpdate, options, cancellationToken));