feat: update generalAccess docs (#2127)

We noticed that we don't have information about updating `generalAccess`
in docs.

This PR updates docs to include `generalAccess` for update(PUT)
endpoints of:
- KV stores
- RQ
- Datasets
- Runs

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Documents and exposes `generalAccess` in schemas and PUT endpoints for
runs, datasets, key‑value stores, and request queues, and expands the
run update endpoint to cover both status and access.
> 
> - **OpenAPI Schemas**:
> - `actor-runs/Run.yaml`: Add `generalAccess` (enum) and include it in
`required`.
> - Add `generalAccess` (enum) to `datasets/Dataset.yaml`,
`key-value-stores/KeyValueStore.yaml`,
`request-queues/RequestQueue.yaml`.
> - Update request schemas to accept `generalAccess` (with examples):
`datasets/UpdateDatasetRequest.yaml`,
`request-queues/UpdateRequestQueueRequest.yaml`,
`store/UpdateStoreRequest.yaml`, `actor-runs/UpdateRunRequest.yaml`.
> - **PUT Endpoints**:
> - `datasets@{datasetId}.yaml`, `key-value-stores@{storeId}.yaml`,
`request-queues@{queueId}.yaml`: Update descriptions to allow updating
`name` and `generalAccess`; add `generalAccess` to request examples.
> - `actor-runs@{runId}.yaml`: Rename summary to "Update run" and expand
description to cover `statusMessage` and `generalAccess` (allowed
values, effects).
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
abbd7d2. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Marcel Rebro <[email protected]>

Author: danpoletaev

apify-api/openapi/components/schemas/actor-runs/Run.yaml

@@ -15,6 +15,7 @@ required:
   - defaultRequestQueueId
   - buildNumber
   - containerUrl
+  - generalAccess
 type: object
 properties:
   id:
@@ -66,6 +67,8 @@ properties:
     type: number
     nullable: true
     example: 0
+  generalAccess:
+    $ref: ../common/GeneralAccessEnum.yaml
   defaultKeyValueStoreId:
     type: string
     example: eJNzqsbPiopwJcgGQ

apify-api/openapi/components/schemas/actor-runs/UpdateRunRequest.yaml

@@ -1,7 +1,4 @@
 title: UpdateRunRequest
-required:
-  - runId
-  - statusMessage
 type: object
 properties:
   runId:
@@ -13,3 +10,5 @@ properties:
   isStatusMessageTerminal:
     type: boolean
     example: true
+  generalAccess:
+    $ref: ../common/GeneralAccessEnum.yaml

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

@@ -0,0 +1,7 @@
+type: string
+enum:
+  - RESTRICTED
+  - ANYONE_WITH_ID_CAN_READ
+  - FOLLOW_USER_SETTING
+example: RESTRICTED
+description: Defines the general access level for the resource.

apify-api/openapi/components/schemas/datasets/Dataset.yaml

@@ -77,5 +77,7 @@ properties:
     type: string
     description: "A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the dataset."
     nullable: true
+  generalAccess:
+    $ref: ../common/GeneralAccessEnum.yaml
   stats:
     $ref: ./DatasetStats.yaml

apify-api/openapi/components/schemas/datasets/UpdateDatasetRequest.yaml

@@ -1,9 +1,10 @@
 title: UpdateDatasetRequest
-required:
-  - name
 type: object
 properties:
   name:
     type: string
+  generalAccess:
+    $ref: ../common/GeneralAccessEnum.yaml
 example:
   name: new-dataset-name
+  generalAccess: RESTRICTED

apify-api/openapi/components/schemas/key-value-stores/KeyValueStore.yaml

@@ -51,5 +51,7 @@ properties:
     type: string
     description: "A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the key-value store."
     nullable: true
+  generalAccess:
+    $ref: ../common/GeneralAccessEnum.yaml
   stats:
     $ref: ./KeyValueStoreStats.yaml

apify-api/openapi/components/schemas/request-queues/RequestQueue.yaml

@@ -46,3 +46,5 @@ properties:
   consoleUrl:
     type: string
     example: 'https://api.apify.com/v2/request-queues/27TmTznX9YPeAYhkC'  
+  generalAccess:
+    $ref: ../common/GeneralAccessEnum.yaml

apify-api/openapi/components/schemas/request-queues/UpdateRequestQueueRequest.yaml

@@ -1,9 +1,10 @@
 title: UpdateRequestQueueRequest
-required:
-  - name
 type: object
 properties:
   name:
     type: string
+  generalAccess:
+    $ref: ../common/GeneralAccessEnum.yaml
 example:
   name: new-request-queue-name
+  generalAccess: RESTRICTED

apify-api/openapi/components/schemas/store/UpdateStoreRequest.yaml

@@ -1,9 +1,10 @@
 title: UpdateStoreRequest
-required:
-  - name
 type: object
 properties:
   name:
     type: string
+  generalAccess:
+    $ref: ../common/GeneralAccessEnum.yaml
 example:
   name: new-store-name
+  generalAccess: RESTRICTED

apify-api/openapi/paths/actor-runs/actor-runs@{runId}.yaml

@@ -186,8 +186,12 @@ get:
 put:
   tags:
     - Actor runs
-  summary: Update status message
+  summary: Update run
   description: |
+    This endpoint can be used to update both the run's status message and to configure its general resource access level.
+
+    **Status message:**
+
     You can set a single status message on your run that will be displayed in
     the Apify Console UI. During an Actor run, you will typically do this in order
     to inform users of your Actor about the Actor's progress.
@@ -196,6 +200,18 @@ put:
     `isStatusMessageTerminal` property is optional and it indicates if the
     status message is the very last one. In the absence of a status message, the
     platform will try to substitute sensible defaults.
+
+    **General resource access:**
+
+    You can also update the run's general resource access setting, which determines who can view the run and its related data.
+    
+    Allowed values:
+
+    * `FOLLOW_USER_SETTING` - The run inherits the general access setting from the account level.
+    * `ANYONE_WITH_ID_CAN_READ` - The run can be viewed anonymously by anyone who has its ID.
+    * `RESTRICTED` - Only users with explicit access to the resource can access the run.
+
+    When a run is accessible anonymously, all of the run's default storages and logs also become accessible anonymously.
   operationId: actorRun_put
   parameters:
     - name: runId