fix(openapi): Update OpenAPI schemas to match API behaviour (#2291)

## Summary

- Adds missing `ActorStandby` schema, missing fields (`actorStandby`,
`exampleRunInput`, `isDeprecated`, `title`, `maxItems`,
`forcePermissionLevel`), and removes incorrect `required` constraints
from request schemas.
- Cleans up `UpdateTaskRequest` to only contain mutable fields (removes
read-only fields like `id`, `userId`, `createdAt`, etc.).

## Related PRs

- apify/apify-client-python#650

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: vdusek

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

@@ -18,3 +18,9 @@ properties:
     anyOf:
       - $ref: ./TaskInput.yaml
       - type: "null"
+  title:
+    type: [string, "null"]
+  actorStandby:
+    anyOf:
+      - $ref: ../actors/ActorStandby.yaml
+      - type: "null"

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

@@ -46,6 +46,12 @@ properties:
     anyOf:
       - $ref: ./TaskInput.yaml
       - type: "null"
+  title:
+    type: [string, "null"]
+  actorStandby:
+    anyOf:
+      - $ref: ../actors/ActorStandby.yaml
+      - type: "null"
   standbyUrl:
     type: [string, "null"]
     format: uri

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

@@ -13,3 +13,5 @@ properties:
   restartOnError:
     type: [boolean, "null"]
     examples: [false]
+  maxItems:
+    type: [integer, "null"]

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

@@ -1,43 +1,9 @@
 title: UpdateTaskRequest
-required:
-  - id
-  - userId
-  - actId
-  - name
-  - createdAt
-  - modifiedAt
 type: object
 properties:
-  id:
-    type: string
-    examples: [ZxLNxrRaZrSjuhT9y]
-  userId:
-    type: string
-    examples: [BPWZBd7Z9c746JAnF]
-  actId:
-    type: string
-    examples: [asADASadYvn4mBZmm]
   name:
     type: string
     examples: [my-task]
-  username:
-    type: [string, "null"]
-    examples: [janedoe]
-  createdAt:
-    type: string
-    format: date-time
-    examples: ["2018-10-26T07:23:14.855Z"]
-  modifiedAt:
-    type: string
-    format: date-time
-    examples: ["2018-10-26T13:30:49.578Z"]
-  removedAt:
-    type: [string, "null"]
-    format: date-time
-  stats:
-    anyOf:
-      - $ref: ./TaskStats.yaml
-      - type: "null"
   options:
     anyOf:
       - $ref: ./TaskOptions.yaml
@@ -46,3 +12,9 @@ properties:
     anyOf:
       - $ref: ./TaskInput.yaml
       - type: "null"
+  title:
+    type: [string, "null"]
+  actorStandby:
+    anyOf:
+      - $ref: ../actors/ActorStandby.yaml
+      - type: "null"

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

@@ -74,6 +74,10 @@ properties:
     anyOf:
       - $ref: ./TaggedBuilds.yaml
       - type: "null"
+  actorStandby:
+    anyOf:
+      - $ref: ./ActorStandby.yaml
+      - type: "null"
   readmeSummary:
     type: string
     description: A brief, LLM-generated readme summary

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

@@ -0,0 +1,19 @@
+title: ActorStandby
+type: object
+properties:
+  isEnabled:
+    type: [boolean, "null"]
+  desiredRequestsPerActorRun:
+    type: [integer, "null"]
+  maxRequestsPerActorRun:
+    type: [integer, "null"]
+  idleTimeoutSecs:
+    type: [integer, "null"]
+  build:
+    type: [string, "null"]
+  memoryMbytes:
+    type: [integer, "null"]
+  disableStandbyFieldsOverride:
+    type: [boolean, "null"]
+  shouldPassActorInput:
+    type: [boolean, "null"]

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

@@ -39,3 +39,13 @@ properties:
     description: ""
   defaultRunOptions:
     $ref: ./DefaultRunOptions.yaml
+  actorStandby:
+    anyOf:
+      - $ref: ./ActorStandby.yaml
+      - type: "null"
+  exampleRunInput:
+    anyOf:
+      - $ref: ./ExampleRunInput.yaml
+      - type: "null"
+  isDeprecated:
+    type: [boolean, "null"]

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

@@ -1,7 +1,4 @@
 title: defaultRunOptions
-required:
-  - build
-  - memoryMbytes
 type: object
 properties:
   build:
@@ -16,3 +13,9 @@ properties:
   restartOnError:
     type: boolean
     examples: [false]
+  maxItems:
+    type: [integer, "null"]
+  forcePermissionLevel:
+    anyOf:
+      - $ref: ./ActorPermissionLevel.yaml
+      - type: "null"

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

@@ -1,7 +1,4 @@
 title: exampleRunInput
-required:
-  - body
-  - contentType
 type: object
 properties:
   body:

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

@@ -92,7 +92,13 @@ properties:
       latest:
         buildId: z2EryhbfhgSyqj6Hn
       beta: null
-required:
-  - name
-  - isPublic
-  - versions
+  actorStandby:
+    anyOf:
+      - $ref: ./ActorStandby.yaml
+      - type: "null"
+  exampleRunInput:
+    anyOf:
+      - $ref: ./ExampleRunInput.yaml
+      - type: "null"
+  isDeprecated:
+    type: [boolean, "null"]