feat: Updated OpenAPI spec (#79)

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

Author: HavenDV

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

@@ -20,29 +20,29 @@ public static ActorStandbyOptionSet Create(string? prefix = null)
             ? string.Empty
             : prefix.Trim().Trim('-') + "-";
         return new ActorStandbyOptionSet(
-                        IsEnabled: CliRuntime.CreateNullableBoolOption(name: $"--{normalizedPrefix}is-enabled", description: @""),
+                        IsEnabled: CliRuntime.CreateNullableBoolOption(name: $"--{normalizedPrefix}is-enabled", description: @"Whether standby mode is enabled for the Actor."),
                 DesiredRequestsPerActorRun: new Option<int?>($"--{normalizedPrefix}desired-requests-per-actor-run")
                 {
-                    Description = @"",
+                    Description = @"Target number of concurrent HTTP requests a single run is configured to handle.",
                 },
                 MaxRequestsPerActorRun: new Option<int?>($"--{normalizedPrefix}max-requests-per-actor-run")
                 {
-                    Description = @"",
+                    Description = @"Maximum number of concurrent HTTP requests that can be routed to a single run.",
                 },
                 IdleTimeoutSecs: new Option<int?>($"--{normalizedPrefix}idle-timeout-secs")
                 {
-                    Description = @"",
+                    Description = @"In seconds, how long a run can stay idle without incoming requests before it's terminated.",
                 },
                 Build: new Option<string?>($"--{normalizedPrefix}build")
                 {
-                    Description = @"",
+                    Description = @"Which build to run in standby mode. Either a build tag or a version number.",
                 },
                 MemoryMbytes: new Option<long?>($"--{normalizedPrefix}memory-mbytes")
                 {
-                    Description = @"",
+                    Description = @"In MB, the amount of memory allocated to the run.",
                 },
-                DisableStandbyFieldsOverride: CliRuntime.CreateNullableBoolOption(name: $"--{normalizedPrefix}disable-standby-fields-override", description: @""),
-                ShouldPassActorInput: CliRuntime.CreateNullableBoolOption(name: $"--{normalizedPrefix}should-pass-actor-input", description: @"")
+                DisableStandbyFieldsOverride: CliRuntime.CreateNullableBoolOption(name: $"--{normalizedPrefix}disable-standby-fields-override", description: @"If `true`, prevents the standby mode configuration from being overridden elsewhere."),
+                ShouldPassActorInput: CliRuntime.CreateNullableBoolOption(name: $"--{normalizedPrefix}should-pass-actor-input", description: @"Whether to pass the Actor's input to the standby run. If `false`, the standby runs start with no input.")
         );
     }
 }

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

@@ -10,41 +10,41 @@ internal static partial class ActorsActsPostCommandApiCommand
     private static Option<string?> NameOption { get; } = new(
         name: @"--name")
     {
-        Description = @"",
+        Description = @"The identifier of the Actor. Use lowercase letters, numbers, and hyphens. Spaces or special characters aren't allowed. Must be unique across your account.",
     };
 
     private static Option<string?> DescriptionOption { get; } = new(
         name: @"--description")
     {
-        Description = @"",
+        Description = @"Short description of the Actor, displayed in Apify Store and Console.",
     };
 
     private static Option<string?> Title { get; } = new(
         name: @"--title")
     {
-        Description = @"",
+        Description = @"Human-readable name of the Actor, displayed in Apify Store and Console. Can contain spaces and capital letters. Recommended length is 40-50 characters. You can change this title without affecting the Actor's URL or SEO.",
     };
 
     private static Option<bool?> IsPublic { get; } = CliRuntime.CreateNullableBoolOption(
         name: @"--is-public",
-        description: @"");
+        description: @"Whether the Actor is available to users in Apify Store. If `false`, the Actor is private and only visible to you.");
 
     private static Option<string?> SeoTitle { get; } = new(
         name: @"--seo-title")
     {
-        Description = @"",
+        Description = @"Name of the Actor to display by search engines such as Google. Can be different from the Actor's name displayed in Apify Store and Console. Recommended length is 40-50 characters.",
     };
 
     private static Option<string?> SeoDescription { get; } = new(
         name: @"--seo-description")
     {
-        Description = @"",
+        Description = @"Description of the Actor to display by search engines such as Google. Recommended length is 140-156 characters.",
     };
 
     private static Option<global::System.Collections.Generic.IList<global::Apify.Version>?> Versions { get; } = new(
         name: @"--versions")
     {
-        Description = @"",
+        Description = @"An array of `Version` objects. Each object represents a specific version of the Actor's source code: its location, builds, and environment configuration.",
     };
 
     private static Option<global::System.Collections.Generic.IList<global::Apify.ActorRunPricingInfo>?> PricingInfos { get; } = new(
@@ -56,12 +56,12 @@ internal static partial class ActorsActsPostCommandApiCommand
     private static Option<global::System.Collections.Generic.IList<string>?> Categories { get; } = new(
         name: @"--categories")
     {
-        Description = @"",
+        Description = @"A list of categories that best define the Actor. Reflected in Apify Store's search and filtering options.",
     };
 
     private static Option<bool?> IsDeprecated { get; } = CliRuntime.CreateNullableBoolOption(
         name: @"--is-deprecated",
-        description: @"");
+        description: @"Whether the Actor is deprecated.");
     private static readonly DefaultRunOptionsOptionSet DefaultRunOptionsOptions = DefaultRunOptionsOptionSet.Create(@"default-run");
 
     private static readonly ActorStandbyOptionSet ActorStandbyOptions = ActorStandbyOptionSet.Create(@"actor-standby");
@@ -107,22 +107,25 @@ private static string FormatResponse(ParseResult parseResult, global::Apify.Acto
     public static Command Create()
     {
         var command = new Command(@"acts-post", @"Create Actor
-Creates a new Actor with settings specified in an Actor object passed as
+Creates an Actor with the settings specified in an `Actor` object passed as
 JSON in the POST payload.
-The response is the full Actor object as returned by the
-[Get Actor](#/reference/actors/actor-object/get-actor) endpoint.
 
-The HTTP request must have the `Content-Type: application/json` HTTP header!
+Returns the full `Actor` object, the same as the
+[Get Actor](/api/v2/act-get) endpoint.
+
+In the HTTP request, set the `Content-Type` header to `application/json`.
+
+### Define a source code version
+
+An Actor must specify at least one version of the source code.
+For details, see [Actor versions](/api/v2/actors-actor-versions).
 
-The Actor needs to define at least one version of the source code.
-For more information, see [Version object](#/reference/actors/version-object).
+### Create a public Actor
 
-If you want to make your Actor
-[public](https://docs.apify.com/platform/actors/publishing) using `isPublic:
-true`, you will need to provide the Actor's `title` and the `categories`
-under which that Actor will be classified in Apify Store. For this, it's
-best to use the [constants from our `apify-shared-js`
-package](https://github.com/apify/apify-shared-js/blob/2d43ebc41ece9ad31cd6525bd523fb86939bf860/packages/consts/src/consts.ts#L452-L471).
+To make your Actor [public](https://docs.apify.com/platform/actors/publishing):
+- Set `isPublic` to `true`.
+- Provide `title` and `categories`. For reference, see [constants from the `apify-shared-js`
+package](https://github.com/apify/apify-shared-js/blob/2d43ebc41ece9ad31cd6525bd523fb86939bf860/packages/consts/src/consts.ts#L452-L471)
 ");
                         command.Options.Add(NameOption);
                         command.Options.Add(DescriptionOption);

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

@@ -19,20 +19,20 @@ public static DefaultRunOptionsOptionSet Create(string? prefix = null)
         return new DefaultRunOptionsOptionSet(
                         Build: new Option<string?>($"--{normalizedPrefix}build")
                 {
-                    Description = @"",
+                    Description = @"Which build to run. Either a build tag or a version number.",
                 },
                 TimeoutSecs: new Option<int?>($"--{normalizedPrefix}timeout-secs")
                 {
-                    Description = @"",
+                    Description = @"Timeout in seconds. 0 if no timeout.",
                 },
                 MemoryMbytes: new Option<long?>($"--{normalizedPrefix}memory-mbytes")
                 {
-                    Description = @"",
+                    Description = @"In MB, the amount of memory allocated to the run.",
                 },
-                RestartOnError: CliRuntime.CreateNullableBoolOption(name: $"--{normalizedPrefix}restart-on-error", description: @""),
+                RestartOnError: CliRuntime.CreateNullableBoolOption(name: $"--{normalizedPrefix}restart-on-error", description: @"Whether to automatically restart the run if it fails."),
                 MaxItems: new Option<int?>($"--{normalizedPrefix}max-items")
                 {
-                    Description = @"",
+                    Description = @"Maximum number of items the run might produce.",
                 }
         );
     }

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

@@ -16,11 +16,11 @@ public static ExampleRunInputOptionSet Create(string? prefix = null)
         return new ExampleRunInputOptionSet(
                         Body: new Option<string?>($"--{normalizedPrefix}body")
                 {
-                    Description = @"",
+                    Description = @"Sample input, serialized as a string.",
                 },
                 ContentType: new Option<string?>($"--{normalizedPrefix}content-type")
                 {
-                    Description = @"",
+                    Description = @"MIME type of `body`.",
                 }
         );
     }