diff --git a/apify-api/openapi/components/schemas/actors/Actor.yaml b/apify-api/openapi/components/schemas/actors/Actor.yaml
index 34cb6c6002..9fab58ec5b 100644
--- a/apify-api/openapi/components/schemas/actors/Actor.yaml
+++ b/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'
diff --git a/apify-api/openapi/components/schemas/actors/ActorPermissionLevel.yaml b/apify-api/openapi/components/schemas/actors/ActorPermissionLevel.yaml
new file mode 100644
index 0000000000..f9c3bedf91
--- /dev/null
+++ b/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
diff --git a/apify-api/openapi/components/schemas/actors/UpdateActorRequest.yaml b/apify-api/openapi/components/schemas/actors/UpdateActorRequest.yaml
index 6be07cd905..aef69f5924 100644
--- a/apify-api/openapi/components/schemas/actors/UpdateActorRequest.yaml
+++ b/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
-
diff --git a/apify-api/openapi/paths/actors/acts@{actorId}.yaml b/apify-api/openapi/paths/actors/acts@{actorId}.yaml
index 89f32a89a8..8a30eb117c 100644
--- a/apify-api/openapi/paths/actors/acts@{actorId}.yaml
+++ b/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: