docs: update understand-how-it-works (#636)

Author: fleuraly

docs/docs/recipes/organizations/understand-how-it-works.mdx

@@ -37,14 +37,18 @@ Organization permissions are not meaningful without the context of an organizati
 
 ## Organization role
 
-Organization role is a grouping of organization permissions that can be assigned to users. The permissions must come from the predefined organization permissions.
+Organization role is a grouping of organization permissions or API permissions that can be assigned to users. The permissions must come from the predefined organization permissions.
 
 <center>
   <img alt="Organization role" src={organizationRole} width={720} />
 </center>
 
 Organization roles are not meaningful without the context of an organization. For example, `admin` in the context of organization `org1` is different from `admin` in the context of organization `org2`.
 
+**Can I assign API permissions to org roles?**
+
+Yes, you can assign API permissions to organization roles. Logto offers the flexibility to manage your organization's roles effectively, allowing you to include both organization permissions and API permissions within those roles.
+
 ## Organization template
 
 Organization template refers to a collection of organization permissions and roles that apply to every organization.