feat: Updated OpenAPI spec (#183)

Co-authored-by: github-actions[bot] <dependabot@bot.com>

Author: HavenDV

src/cli/Apify.CLI/Commands/ActorBuildsActorBuildOpenapiJsonGetCommandApiCommand.g.cs

@@ -42,15 +42,15 @@ public static Command Create(string? commandName = null)
         var command = new Command(commandName ?? @"openapi-json-get", @"Get OpenAPI definition of Actor build
 Get the OpenAPI definition for Actor builds. Two similar endpoints are available:
 
-- [First endpoint](/api/v2/actor-openapi-json-get): Requires both `actorId` and `buildId`. Use `default` as the `buildId` to get the OpenAPI schema for the default Actor build.
-- [Second endpoint](/api/v2/actor-build-openapi-json-get): Requires only `buildId`.
+- [Get OpenAPI definition of Actor build](/api/v2/actor-openapi-json-get) (`/v2/actors/{actorId}/builds/{buildId}/openapi.json`): Requires both `actorId` and `buildId`. Use `default` as the `buildId` to get the OpenAPI schema for the default Actor build.
+- [Get OpenAPI definition of Actor build](/api/v2/actor-build-openapi-json-get) (`/v2/actor-builds/{buildId}/openapi.json`): Requires only `buildId`.
 
 Get the OpenAPI definition for a specific Actor build.
 Authentication is based on the build's unique ID. No authentication token is required.
 
 :::note
 
-You can also use the [`/api/v2/actor-openapi-json-get`](/api/v2/actor-openapi-json-get) endpoint to get the OpenAPI definition for a build.
+You can also use the [Get OpenAPI definition of Actor build](/api/v2/actor-openapi-json-get) endpoint (`/v2/actors/{actorId}/builds/{buildId}/openapi.json`) to get the OpenAPI definition for a build.
 
 :::
 ");

src/cli/Apify.CLI/Commands/ActorRunsActorRunGetCommandApiCommand.g.cs

@@ -53,11 +53,11 @@ public static Command Create(string? commandName = null)
 
 ##### Convenience endpoints for Actor run default storages
 
-* [Dataset](/api/v2/default-dataset)
+* [Default dataset](/api/v2/default-dataset)
 
-* [Key-value store](/api/v2/default-key-value-store)
+* [Default key-value store](/api/v2/default-key-value-store)
 
-* [Request queue](/api/v2/default-request-queue)
+* [Default request queue](/api/v2/default-request-queue)
 
 Gets an object that contains all the details about a
 specific run of an Actor.

src/cli/Apify.CLI/Commands/ActorTasksActorTaskInputPutCommandApiCommand.g.cs

@@ -60,14 +60,14 @@ JSON in the PUT payload.
 If the object does not define a specific property, its value is not updated.
 
 The response is the full task input as returned by the
-[Get task input](#/reference/tasks/task-input-object/get-task-input) endpoint.
+[Get Actor task input](/api/v2/actor-task-input-get) endpoint.
 
 The request needs to specify the `Content-Type: application/json` HTTP
 header!
 
 When providing your API authentication token, we recommend using the
-request's `Authorization` header, rather than the URL. ([More
-info](#/introduction/authentication)).
+request's `Authorization` header, rather than the URL.
+For details, see [Authentication](/api/v2/getting-started#authentication).
 ");
                         command.Arguments.Add(ActorTaskId);
           command.Options.Add(Input);

src/cli/Apify.CLI/Commands/ActorTasksActorTaskRunSyncGetCommandApiCommand.g.cs

@@ -123,7 +123,7 @@ configured to have a long enough connection timeout.
 and its status.
 
 To run the Task asynchronously, use the
-[Run task asynchronously](#/reference/actor-tasks/run-collection/run-task)
+[Run Actor task](/api/v2/actor-task-runs-post)
 endpoint instead.
 ");
                         command.Arguments.Add(ActorTaskId);

src/cli/Apify.CLI/Commands/ActorTasksActorTaskRunSyncGetDatasetItemsGetCommandApiCommand.g.cs

@@ -272,8 +272,7 @@ public static Command Create(string? commandName = null)
 otherwise the HTTP request fails with a timeout error (this won't abort
 the run itself).
 
-You can send all the same options in parameters as the [Get Dataset
-Items](#/reference/datasets/item-collection/get-items) API endpoint.
+You can send all the same options in parameters as the [Get dataset items](/api/v2/dataset-items-get) API endpoint.
 
 Beware that it might be impossible to maintain an idle HTTP connection for
 an extended period, due to client timeout or network conditions. Make sure your HTTP client is
@@ -282,8 +281,7 @@ configured to have a long enough connection timeout.
 If the connection breaks, you will not receive any information about the run
 and its status.
 
-To run the Task asynchronously, use the [Run task
-asynchronously](#/reference/actor-tasks/run-collection/run-task) endpoint
+To run the Task asynchronously, use the [Run Actor task](/api/v2/actor-task-runs-post) endpoint
 instead.
 ");
                         command.Arguments.Add(ActorTaskId);

src/cli/Apify.CLI/Commands/ActorTasksActorTaskRunSyncGetDatasetItemsPostCommandApiCommand.g.cs

@@ -300,8 +300,7 @@ otherwise the HTTP request fails with a timeout error (this won't abort
 input property, the Actor run uses the default value defined by the task (or the Actor's
 input schema if not defined by the task).
 
-You can send all the same options in parameters as the [Get Dataset
-Items](#/reference/datasets/item-collection/get-items) API endpoint.
+You can send all the same options in parameters as the [Get dataset items](/api/v2/dataset-items-get) API endpoint.
 
 Beware that it might be impossible to maintain an idle HTTP connection for
 an extended period, due to client timeout or network conditions. Make sure your HTTP client is
@@ -316,8 +315,7 @@ passed as the POST payload.
 Just make sure to specify the `Content-Type` header as `application/json`
 and that the input is an object.
 
-To run the task asynchronously, use the [Run
-task](#/reference/actor-tasks/run-collection/run-task) API endpoint instead.
+To run the task asynchronously, use the [Run Actor task](/api/v2/actor-task-runs-post) API endpoint instead.
 ");
                         command.Arguments.Add(ActorTaskId);
                         command.Options.Add(Timeout);

src/cli/Apify.CLI/Commands/ActorTasksActorTaskRunSyncPostCommandApiCommand.g.cs

@@ -156,8 +156,7 @@ passed as the POST payload.
 Just make sure to specify `Content-Type` header to be `application/json` and
 input to be an object.
 
-To run the task asynchronously, use the [Run
-task](#/reference/actor-tasks/run-collection/run-task) API endpoint instead.
+To run the task asynchronously, use the [Run Actor task](/api/v2/actor-task-runs-post) API endpoint instead.
 ");
                         command.Arguments.Add(ActorTaskId);
                         command.Options.Add(Timeout);

src/cli/Apify.CLI/Commands/ActorTasksActorTaskRunsLastGetCommandApiCommand.g.cs

@@ -71,17 +71,17 @@ All the endpoints require an authentication token.
 Using the `status` query parameter you can ensure to only get a run with a certain status
 (e.g. `status=SUCCEEDED`). Similarly, the `origin` query parameter filters runs by the means
 by which they were started (e.g. `origin=API`). The output of this endpoint and other query
-parameters are the same as in the [Run object](/api/v2/actor-run-get) endpoint.
+parameters are the same as in the [Get Actor run](/api/v2/actor-run-get) endpoint.
 
 ##### Convenience endpoints for last Actor task run
 
-* [Dataset](/api/v2/last-actor-task-runs-default-dataset)
+* [Last Actor task run's default dataset](/api/v2/last-actor-task-runs-default-dataset)
 
-* [Key-value store](/api/v2/last-actor-task-runs-default-key-value-store)
+* [Last Actor task run's default key-value store](/api/v2/last-actor-task-runs-default-key-value-store)
 
-* [Request queue](/api/v2/last-actor-task-runs-default-request-queue)
+* [Last Actor task run's default request queue](/api/v2/last-actor-task-runs-default-request-queue)
 
-* [Log](/api/v2/last-actor-task-runs-log)
+* [Last Actor task run's log](/api/v2/last-actor-task-runs-log)
 ");
                         command.Arguments.Add(ActorTaskId);
                         command.Options.Add(Status);

src/cli/Apify.CLI/Commands/ActorTasksActorTaskRunsPostCommandApiCommand.g.cs

@@ -134,18 +134,17 @@ public static Command Create(string? commandName = null)
 input property, the Actor run uses the default value defined by the task (or Actor's input
 schema if not defined by the task).
 
-The response is the Actor Run object as returned by the [Get
-run](#/reference/actor-runs/run-object-and-its-storages/get-run) endpoint.
+The response is the Actor Run object as returned by the [Get Actor run](/api/v2/actor-run-get) endpoint.
 
 If you want to wait for the run to finish and receive the actual output of
-the Actor run as the response, use one of the [Run task
-synchronously](#/reference/actor-tasks/run-task-synchronously) API endpoints
-instead.
+the Actor run as the response, use the [Run Actor task synchronously and get key-value store record](/api/v2/actor-task-run-sync-post)
+or [Run Actor task synchronously and get dataset items](/api/v2/actor-task-run-sync-get-dataset-items-post)
+endpoint instead.
 
 To fetch the Actor run results that are typically stored in the default
 dataset, you'll need to pass the ID received in the `defaultDatasetId` field
 received in the response JSON to the
-[Get dataset items](#/reference/datasets/item-collection/get-items) API endpoint.
+[Get dataset items](/api/v2/dataset-items-get) API endpoint.
 ");
                         command.Arguments.Add(ActorTaskId);
                         command.Options.Add(Timeout);

src/cli/Apify.CLI/Commands/ActorsActorBuildsActorOpenapiJsonGetCommandApiCommand.g.cs

@@ -48,9 +48,9 @@ public static Command Create(string? commandName = null)
         var command = new Command(commandName ?? @"actor-openapi-json-get", @"Get OpenAPI definition of Actor build
 Get the OpenAPI definition for Actor builds. Two similar endpoints are available:
 
-- [First endpoint](/api/v2/actor-openapi-json-get): Requires both `actorId` and `buildId`. Use `default` as the `buildId` to get the OpenAPI schema for the default Actor build.
+- [Get OpenAPI definition of Actor build](/api/v2/actor-openapi-json-get) (`/v2/actors/{actorId}/builds/{buildId}/openapi.json`): Requires both `actorId` and `buildId`. Use `default` as the `buildId` to get the OpenAPI schema for the default Actor build.
 
-- [Second endpoint](/api/v2/actor-build-openapi-json-get): Requires only `buildId`.
+- [Get OpenAPI definition of Actor build](/api/v2/actor-build-openapi-json-get) (`/v2/actor-builds/{buildId}/openapi.json`): Requires only `buildId`.
 
 Get the OpenAPI definition for a specific Actor build.
 
@@ -59,7 +59,7 @@ Authentication is based on the build's unique ID. No authentication token is req
 
 :::note
 
-You can also use the [`/api/v2/actor-build-openapi-json-get`](/api/v2/actor-build-openapi-json-get) endpoint to get the OpenAPI definition for a build.
+You can also use the [Get OpenAPI definition of Actor build](/api/v2/actor-build-openapi-json-get) endpoint (`/v2/actor-builds/{buildId}/openapi.json`) to get the OpenAPI definition for a build.
 
 :::
 ");