chore(api): add the new 'ownership' parameter for listing storages (#2208)

Document the new 'ownership' parameter in the listing requests for
storages.


<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Documents a new optional `ownership` query parameter for storage
listing endpoints to filter by resource ownership.
> 
> - Adds `ownership` to `GET` listings for datasets, key-value stores,
and request queues (`datasets.yaml`, `key-value-stores.yaml`,
`request-queues.yaml`)
> - Accepts `ownedByMe` or `sharedWithMe`; default remains all
accessible resources
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
ee02f2e. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: nmanerikar

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

@@ -0,0 +1,5 @@
+type: string
+enum:
+  - ownedByMe
+  - sharedWithMe
+examples: [ownedByMe]

apify-api/openapi/paths/datasets/datasets.yaml

@@ -54,6 +54,17 @@ get:
       schema:
         type: boolean
         example: true
+    - name: ownership
+      in: query
+      description: |
+        Filter by ownership. If this parameter is omitted, all accessible datasets are returned.
+
+        - `ownedByMe`: Return only datasets owned by the user.
+        - `sharedWithMe`: Return only datasets shared with the user by other users.
+      style: form
+      explode: true
+      schema:
+        $ref: ../../components/schemas/common/StorageOwnership.yaml
   responses:
     "200":
       description: ""

apify-api/openapi/paths/key-value-stores/key-value-stores.yaml

@@ -59,6 +59,17 @@ get:
       schema:
         type: boolean
         example: true
+    - name: ownership
+      in: query
+      description: |
+        Filter by ownership. If this parameter is omitted, all accessible key-value stores are returned.
+
+        - `ownedByMe`: Return only key-value stores owned by the user.
+        - `sharedWithMe`: Return only key-value stores shared with the user by other users.
+      style: form
+      explode: true
+      schema:
+        $ref: ../../components/schemas/common/StorageOwnership.yaml
   responses:
     "200":
       description: ""

apify-api/openapi/paths/request-queues/request-queues.yaml

@@ -57,6 +57,17 @@ get:
       schema:
         type: boolean
         example: true
+    - name: ownership
+      in: query
+      description: |
+        Filter by ownership. If this parameter is omitted, all accessible request queues are returned.
+
+        - `ownedByMe`: Return only request queues owned by the user.
+        - `sharedWithMe`: Return only request queues shared with the user by other users.
+      style: form
+      explode: true
+      schema:
+        $ref: ../../components/schemas/common/StorageOwnership.yaml
   responses:
     "200":
       description: ""