docs(openapi): Align 404 to use generic error and specific example (#2422)

- Add missing, but possible errors to the `ErrorResponse.yaml`
- Simplify 404s to refer to a generic error and give generic missing
resource text

**Motivation:** 
- Simplify code generation by reducing the number of error objects.
- Simplify upcoming documentation of redispatch endpoints (This will
allow complete reuse of the response section. Using granular 404s would
not allow it due to, for example, `last run` endpoints always having
`actor/run not found` errors even when referring to the default dataset,
while getting the dataset directly through id will never return such 404
variant )

Follow up for: #2398

Partially implements: #2286

Author: Pijukatel

apify-api/openapi/components/objects/actors/acts@{actorId}@versions@{versionNumber}@env-vars@{envVarName}put.yaml

@@ -43,14 +43,7 @@ shared: &shared
     "403":
       $ref: ../../responses/Forbidden.yaml
     "404":
-      description: Not found - the requested resource was not found.
-      content:
-        application/json:
-          schema:
-            oneOf:
-              - $ref: "../../schemas/common/errors/ActorErrors.yaml#/ActorNotFoundError"
-              - $ref: "../../schemas/common/errors/ActorErrors.yaml#/ActorVersionNotFoundError"
-              - $ref: "../../schemas/common/errors/EnvVariableErrors.yaml#/EnvironmentVariableNotFoundError"
+      $ref: ../../responses/NotFound.yaml
     "405":
       $ref: ../../responses/MethodNotAllowed.yaml
     "413":

apify-api/openapi/components/objects/actors/acts@{actorId}@versions@{versionNumber}put.yaml

@@ -39,11 +39,7 @@ shared: &shared
     "403":
       $ref: ../../responses/Forbidden.yaml
     "404":
-      description: Not found - the requested resource was not found.
-      content:
-        application/json:
-          schema:
-            $ref: "../../schemas/common/errors/ActorErrors.yaml#/ActorNotFoundError"
+      $ref: ../../responses/NotFound.yaml
     "405":
       $ref: ../../responses/MethodNotAllowed.yaml
     "413":

apify-api/openapi/components/responses/RunTimeout.yaml

@@ -0,0 +1,9 @@
+description: The HTTP request exceeded the timeout limit
+content:
+  application/json:
+    schema:
+      $ref: ../schemas/common/ErrorResponse.yaml
+    example:
+      error:
+        type: run-timeout-exceeded
+        message: Actor run exceeded the timeout of 300 seconds for this API endpoint

apify-api/openapi/components/schemas/common/ErrorResponse.yaml

@@ -4,30 +4,4 @@ required:
 type: object
 properties:
   error:
-    title: ErrorDetail
-    type: object
-    properties:
-      type:
-        title: ErrorType
-        type: string
-        description: Machine-processable error type identifier.
-        enum:
-          - actor-memory-limit-exceeded
-          - actor-not-found
-          - invalid-input
-          - method-not-allowed
-          - permission-denied
-          - rate-limit-exceeded
-          - record-not-found
-          - record-not-unique
-          - record-or-token-not-found
-          - request-id-invalid
-          - request-too-large
-          - run-failed
-          - run-timeout-exceeded
-          - token-not-valid
-          - unknown-build-tag
-          - unsupported-content-encoding
-      message:
-        type: string
-        description: Human-readable error message describing what went wrong.
+    $ref: ErrorDetail.yaml

apify-api/openapi/components/schemas/common/ErrorType.yaml

@@ -6,6 +6,7 @@ enum:
   - actor-not-found
   - invalid-input
   - method-not-allowed
+  - page-not-found
   - permission-denied
   - rate-limit-exceeded
   - record-not-found
@@ -15,6 +16,9 @@ enum:
   - request-too-large
   - run-failed
   - run-timeout-exceeded
+  - schedule-actor-not-found
+  - schedule-actor-task-not-found
   - token-not-valid
   - unknown-build-tag
   - unsupported-content-encoding
+  - user-not-found

apify-api/openapi/components/schemas/common/errors/ActorErrors.yaml

@@ -1,27 +1,3 @@
-ActorNotFoundErrorDetail:
-  allOf:
-    - $ref: ../ErrorDetail.yaml
-    - type: object
-      properties:
-        type:
-          const: actor-not-found
-
-RecordNotFoundErrorDetail:
-  allOf:
-    - $ref: ../ErrorDetail.yaml
-    - type: object
-      properties:
-        type:
-          const: record-not-found
-
-RecordOrTokenNotFoundErrorDetail:
-  allOf:
-    - $ref: ../ErrorDetail.yaml
-    - type: object
-      properties:
-        type:
-          const: record-or-token-not-found
-
 RunFailedErrorDetail:
   allOf:
     - $ref: ../ErrorDetail.yaml
@@ -38,46 +14,6 @@ RunTimeoutExceededErrorDetail:
         type:
           const: run-timeout-exceeded
 
-ActorNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "#/ActorNotFoundErrorDetail"
-  example:
-    error:
-      type: actor-not-found
-      message: Actor was not found
-
-ActorBuildNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "#/RecordNotFoundErrorDetail"
-  example:
-    error:
-      type: record-not-found
-      message: Actor build was not found
-
-RecordOrTokenNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "#/RecordOrTokenNotFoundErrorDetail"
-  example:
-    error:
-      type: record-or-token-not-found
-      message: Actor was not found or access denied
-
-ActorRunNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "#/RecordNotFoundErrorDetail"
-  example:
-    error:
-      type: record-not-found
-      message: Actor run was not found
-
 ActorRunTimeoutExceededError:
   type: object
   properties:
@@ -97,13 +33,3 @@ ActorRunFailedError:
     error:
       type: run-failed
       message: "Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)"
-
-ActorVersionNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "#/RecordNotFoundErrorDetail"
-  example:
-    error:
-      type: record-not-found
-      message: Actor version was not found

apify-api/openapi/components/schemas/common/errors/EnvVariableErrors.yaml

@@ -6,56 +6,6 @@ RequestIdInvalidErrorDetail:
         type:
           const: request-id-invalid
 
-DatasetNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "./ActorErrors.yaml#/RecordNotFoundErrorDetail"
-  example:
-    error:
-      type: record-not-found
-      message: Dataset was not found
-
-KeyValueStoreNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "./ActorErrors.yaml#/RecordNotFoundErrorDetail"
-  example:
-    error:
-      type: record-not-found
-      message: Key-value Store was not found
-
-RequestQueueNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "./ActorErrors.yaml#/RecordNotFoundErrorDetail"
-  example:
-    error:
-      type: record-not-found
-      message: Request Queue was not found
-
-RecordNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "./ActorErrors.yaml#/RecordNotFoundErrorDetail"
-  example:
-    error:
-      type: record-not-found
-      message: Record was not found
-
-RequestNotFoundError:
-  type: object
-  properties:
-    error:
-      $ref: "./ActorErrors.yaml#/RecordNotFoundErrorDetail"
-  example:
-    error:
-      type: record-not-found
-      message: Request was not found
-
 RequestIdInvalidError:
   type: object
   properties:

apify-api/openapi/components/schemas/common/errors/StorageErrors.yaml

@@ -33,11 +33,7 @@ get:
     "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#/ActorBuildNotFoundError"
+      $ref: ../../components/responses/NotFound.yaml
     "405":
       $ref: ../../components/responses/MethodNotAllowed.yaml
     "429":
@@ -76,13 +72,7 @@ delete:
     "403":
       $ref: ../../components/responses/Forbidden.yaml
     "404":
-      description: Not found - the requested resource was not found.
-      content:
-        application/json:
-          schema:
-            oneOf:
-              - $ref: "../../components/schemas/common/errors/ActorErrors.yaml#/ActorBuildNotFoundError"
-              - $ref: "../../components/schemas/common/errors/ActorErrors.yaml#/RecordOrTokenNotFoundError"
+      $ref: ../../components/responses/NotFound.yaml
     "405":
       $ref: ../../components/responses/MethodNotAllowed.yaml
     "429":

apify-api/openapi/paths/actor-builds/actor-builds@{buildId}.yaml

@@ -27,11 +27,7 @@ post:
     "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#/ActorBuildNotFoundError"
+      $ref: ../../components/responses/NotFound.yaml
     "405":
       $ref: ../../components/responses/MethodNotAllowed.yaml
     "429":