fix(openapi): Deduplicate error schemas and fix titles for codegen compatibility (#2398)

## Summary

- Extract reusable `ErrorDetail` schema referenced by all error
responses (eliminates 14 duplicate inline error objects)
- Fix 6 schema titles that didn't match component names (broke
`use_title_as_name` codegen)
- Use `const` instead of single-value `enum` in schedule action type
fields
- Add titles to inline schemas in `RequestDraftDelete`,
`DeletedRequest`, and `DecodeAndVerifyResponse`
- Also see the apify/apify-client-python#704

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: vdusek

.github/workflows/openapi-ci.yaml

@@ -149,7 +149,7 @@ jobs:
                   GITHUB_TOKEN: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
                   PR_NUMBER: ${{ github.event.pull_request.number }}
               run: |
-                  gh workflow run regenerate_models.yaml \
+                  gh workflow run manual_regenerate_models.yaml \
                       --repo apify/apify-client-python \
                       --field docs_pr_number="$PR_NUMBER" \
                       --field docs_workflow_run_id="${{ github.run_id }}"
@@ -169,7 +169,7 @@ jobs:
               env:
                   GITHUB_TOKEN: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
                   PR_NUMBER: ${{ github.event.pull_request.number }}
-              # Branch name convention must match what regenerate_models.yaml creates.
+              # Branch name convention must match what manual_regenerate_models.yaml creates.
               run: |
                   BRANCH="update-models-docs-pr-${PR_NUMBER}"
                   EXISTING_PR=$(gh pr list \

apify-api/openapi/components/schemas/actor-tasks/CreateTaskRequest.yaml

@@ -12,7 +12,7 @@ properties:
     examples: [my-task]
   options:
     anyOf:
-      - $ref: ../common/OptionalRunOptions.yaml
+      - $ref: ../common/TaskOptions.yaml
       - type: "null"
   input:
     anyOf:

apify-api/openapi/components/schemas/actor-tasks/Task.yaml

@@ -40,7 +40,7 @@ properties:
       - type: "null"
   options:
     anyOf:
-      - $ref: ../common/OptionalRunOptions.yaml
+      - $ref: ../common/TaskOptions.yaml
       - type: "null"
   input:
     anyOf:

apify-api/openapi/components/schemas/actor-tasks/UpdateTaskRequest.yaml

@@ -6,7 +6,7 @@ properties:
     examples: [my-task]
   options:
     anyOf:
-      - $ref: ../common/OptionalRunOptions.yaml
+      - $ref: ../common/TaskOptions.yaml
       - type: "null"
   input:
     anyOf:

apify-api/openapi/components/schemas/actors/DefaultRunOptions.yaml

@@ -1,4 +1,4 @@
-title: defaultRunOptions
+title: DefaultRunOptions
 type: object
 properties:
   build:

apify-api/openapi/components/schemas/actors/EnvVarResponse.yaml

@@ -1,4 +1,4 @@
-title: CreateEnvironmentVariableResponse
+title: EnvVarResponse
 required:
   - data
 type: object

apify-api/openapi/components/schemas/actors/ExampleRunInput.yaml

@@ -1,4 +1,4 @@
-title: exampleRunInput
+title: ExampleRunInput
 type: object
 properties:
   body:

apify-api/openapi/components/schemas/actors/UpdateActorRequest.yaml

@@ -1,4 +1,4 @@
-title: ActUpdate
+title: UpdateActorRequest
 type: object
 properties:
   name:

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

@@ -0,0 +1,8 @@
+title: ErrorDetail
+type: object
+properties:
+  type:
+    $ref: ErrorType.yaml
+  message:
+    type: string
+    description: Human-readable error message describing what went wrong.

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

@@ -4,15 +4,30 @@ required:
 type: object
 properties:
   error:
+    title: ErrorDetail
     type: object
-    required:
-      - type
-      - message
     properties:
       type:
+        title: ErrorType
         type: string
-        examples: [run-failed]
+        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
-        examples:
-          - "Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)"
+        description: Human-readable error message describing what went wrong.