feat: Add summary and description to 204 response for input validation

apify-api/openapi/openapi.yaml

@@ -510,6 +510,8 @@ paths:
     $ref: "paths/actors/acts@{actorId}@run-sync.yaml"
   "/v2/acts/{actorId}/run-sync-get-dataset-items":
     $ref: "paths/actors/acts@{actorId}@run-sync-get-dataset-items.yaml"
+  "/v2/acts/{actorId}/validate-input":
+    $ref: "paths/actors/acts@{actorId}@validate-input.yaml"
   "/v2/acts/{actorId}/runs/{runId}/resurrect":
     $ref: "paths/actors/acts@{actorId}@runs@{runId}@resurrect.yaml"
   "/v2/acts/{actorId}/runs/last":

apify-api/openapi/paths/actors/acts@{actorId}.yaml

@@ -295,7 +295,8 @@ delete:
     - $ref: "../../components/parameters/runAndBuildParameters.yaml#/actorId"
   responses:
     "204":
-      description: ""
+      summary: Success
+      description: The Actor was successfully deleted.
       headers: {}
       content:
         application/json:

apify-api/openapi/paths/actors/acts@{actorId}@validate-input.yaml

@@ -0,0 +1,62 @@
+post:
+  tags:
+    - Actors
+  summary: Validate Actor input
+  description: |
+    Validates whether the provided JSON payload matches the Actor input schema without starting a run.
+    Use this endpoint before triggering an Actor to catch schema violations and return actionable error messages.
+  operationId: act_validate_input_post
+  parameters:
+    - $ref: "../../components/parameters/runAndBuildParameters.yaml#/actorId"
+    - name: build
+      in: query
+<<<<<<< HEAD
+      description: |
+        Specifies the Actor build to validate against. It can be either a build tag or build number.
+        By default, the validation uses the Actor's `latest` build.
+      style: form
+      explode: true
+      schema:
+        type: string
+        example: 0.1.234
+
+=======
+      description: |-
+        The build to be used by the run. It can be a build number (`1.2.3`), or a build tag (`latest` or `beta`).
+        If not provided, the `default` build will be used.
+      schema:
+        type: string
+>>>>>>> 9a620738a7b1d02f4073624da04a340de5064783
+  requestBody:
+    description: JSON payload to validate against the Actor input schema.
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          additionalProperties: true
+  responses:
+    "204":
+      summary: Input is valid
+      description: The provided input is valid against the Actor's input schema.
+    "400":
+      $ref: ../../components/responses/BadRequest.yaml
+    "401":
+      $ref: ../../components/responses/Unauthorized.yaml
+    "403":
+      $ref: ../../components/responses/Forbidden.yaml
+    "404":
+      description: Not found - the requested resource was not found.
+      content:
+        application/json:
+          schema:
+            $ref: "../../components/schemas/common/errors/ActorErrors.yaml#/ActorNotFoundError"
+    "405":
+      $ref: ../../components/responses/MethodNotAllowed.yaml
+    "413":
+      $ref: ../../components/responses/PayloadTooLarge.yaml
+    "415":
+      $ref: ../../components/responses/UnsupportedMediaType.yaml
+    "429":
+      $ref: ../../components/responses/TooManyRequests.yaml
+  deprecated: false