docs: add actorPermissionLevel to API reference (#2135)

Adds missing `actorPermissionLevel` to the Actor's OpenAPI spec.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Adds `actorPermissionLevel` enum field to `Actor` and
`UpdateActorRequest` schemas and includes it in Update Actor
request/response examples.
> 
> - **OpenAPI Schemas**:
> - `components/schemas/actors/Actor.yaml`: Add `actorPermissionLevel`
(`LIMITED_PERMISSIONS` | `FULL_PERMISSIONS`, nullable) with example.
> - `components/schemas/actors/UpdateActorRequest.yaml`: Add
`actorPermissionLevel` (same enum/nullable) with example.
> - **Paths**:
> - `paths/actors/acts@{actorId}.yaml` (PUT Update Actor): Include
`actorPermissionLevel` in request body example and response example.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
bb08633. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: stepskop

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

@@ -36,6 +36,8 @@ properties:
   isPublic:
     type: boolean
     example: false
+  actorPermissionLevel:
+    $ref: ./ActorPermissionLevel.yaml
   createdAt:
     type: string
     example: '2019-07-08T11:27:57.401Z'

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

@@ -0,0 +1,8 @@
+type: string
+description: >
+  Determines permissions that the Actor requires to run.
+  For more information, see the [Actor permissions documentation](https://docs.apify.com/platform/actors/development/permissions).
+enum:
+  - LIMITED_PERMISSIONS
+  - FULL_PERMISSIONS
+example: LIMITED_PERMISSIONS

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

@@ -11,6 +11,9 @@ properties:
   isPublic:
     type: boolean
     example: false
+  actorPermissionLevel:
+    nullable: true
+    $ref: ./ActorPermissionLevel.yaml
   seoTitle:
     type: string
     nullable: true
@@ -102,4 +105,3 @@ required:
   - name
   - isPublic
   - versions
-

apify-api/openapi/paths/actors/acts@{actorId}.yaml

@@ -140,6 +140,7 @@ put:
               name: MyActor
               description: My favourite Actor!
               isPublic: false
+              actorPermissionLevel: 'LIMITED_PERMISSIONS'
               seoTitle: My Actor
               seoDescription: My Actor is the best
               title: My Actor
@@ -197,6 +198,7 @@ put:
               username: jane35
               description: My favourite Actor!
               isPublic: false
+              actorPermissionLevel: 'LIMITED_PERMISSIONS'
               createdAt: '2019-07-08T11:27:57.401Z'
               modifiedAt: '2019-07-08T14:01:05.546Z'
               stats: