Permission scopes

Overview of Miro's user access control through scopes, defining app permissions for interacting with boards and resources via REST API and Web SDK.

Scope Description Available For
All plans
boards:read Retrieve information about boards, board members, or items. Web SDK REST API
boards:write Create, update, or delete boards, board members, or items. Web SDK REST API
identity:read Read profile information for current user, including email. Web SDK
identity:write Modify profile information for current user. Web SDK
team:read Read current team information. Web SDK
team:write Modify current team title, invite users, change users' roles. Web SDK
microphone:listen Access a user's microphone to record audio in an iFrame. Web SDK
screen:record Access a user's screen to record it in an iFrame Web SDK
webcam:record Allows an iFrame to access a user's camera to record video Web SDK
Enterprise plan only
auditlogs:read Read audit logs for this team's organization. Enterprise
organizations:read Retrieve information about the organization, such as name, plan, number of licenses, organization settings, or organization members. REST API
organizations:teams:read Retrieve team information, such as the list of teams, team settings, team members, for an organization. REST API
organizations:teams:write Create or delete teams, update team information, team settings, team members, for an organization. Enterprise
organizations:groups:read Read organization user group information, user group members. Enterprise
organizations:groups:write Modify organization user group information, user group members. Enterprise
projects:read Retrieve project information, such as the list of projects, project settings, and project members. Web SDK REST API
projects:write Create or delete projects, update project information, project settings, and project members. Web SDK REST API
contentlogs:export Export all activity on all boards within your organization. Enterprise Guard
boards:export Export boards within your organization as PDF with comments and talktrack. Enterprise
sessions:delete Reset all sessions for a user, which ends all active Miro sessions across devices for a particular user, requiring the user to sign in again. Enterprise
organizations:cases:management Retrieve information about a specific case, retrieve all cases for an organization, retrieve information about a specific legal hold, retrieve all legal holds within a case, retrieve all content items under a specific legal hold. Enterprise Guard