---
updatedAt: 2026-03-19T19:40:48.000Z
---

Fetch the complete documentation index at: https://developers.miro.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# 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.

[block:html]
{
  "html": "<table style=\"width:100%; border-collapse:collapse; font-family:Arial, sans-serif; font-size:14px;\">\n  <thead>\n    <tr style=\"background-color:#4A4A4A; color:#FFFFFF; text-align:left;\">\n      <th style=\"padding:10px; border-bottom:2px solid #6C6C6C;\">Scope</th>\n      <th style=\"padding:10px; border-bottom:2px solid #6C6C6C;\">Description</th>\n      <th style=\"padding:10px; border-bottom:2px solid #6C6C6C; text-align:center;\">Available For</th>\n    </tr>\n  </thead>\n  <tbody>\n    <!-- All plans subheader -->\n    <tr style=\"background-color:#EEEEEE; color:#333;\">\n      <td colspan=\"3\" style=\"padding:10px; border:1px solid #E0E0E0; font-weight:bold;\">\n        All plans\n      </td>\n    </tr>\n\n    <!-- All plans scopes -->\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>boards:read</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Retrieve information about boards, board members, or items.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n        <span style=\"background-color:#fbe9e7; color:#bf360c; padding:2px 8px; border-radius:12px; font-size:12px;\">REST API</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>boards:write</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Create, update, or delete boards, board members, or items.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n        <span style=\"background-color:#fbe9e7; color:#bf360c; padding:2px 8px; border-radius:12px; font-size:12px;\">REST API</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>identity:read</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Read profile information for current user, including email.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>identity:write</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Modify profile information for current user.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>team:read</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Read current team information.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>team:write</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Modify current team title, invite users, change users' roles.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>microphone:listen</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Access a user's microphone to record audio in an iFrame.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>screen:record</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Access a user's screen to record it in an iFrame   </td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>webcam:record</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Allows an iFrame to access a user's camera to record video</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n      </td>\n    </tr>\n\n    <!-- Enterprise plan only subheader -->\n    <tr style=\"background-color:#EEEEEE; color:#333;\">\n      <td colspan=\"3\" style=\"padding:10px; border:1px solid #E0E0E0; font-weight:bold;\">\n        Enterprise plan only\n      </td>\n    </tr>\n\n    <!-- Enterprise plan only scopes -->\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>auditlogs:read</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Read audit logs for this team's organization.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e0f7fa; color:#006064; padding:2px 8px; border-radius:12px; font-size:12px;\">Enterprise</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>organizations:read</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Retrieve information about the organization, such as name, plan, number of licenses, organization settings, or organization members.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#fbe9e7; color:#bf360c; padding:2px 8px; border-radius:12px; font-size:12px;\">REST API</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>organizations:teams:read</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Retrieve team information, such as the list of teams, team settings, team members, for an organization.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#fbe9e7; color:#bf360c; padding:2px 8px; border-radius:12px; font-size:12px;\">REST API</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>organizations:teams:write</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Create or delete teams, update team information, team settings, team members, for an organization.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e0f7fa; color:#006064; padding:2px 8px; border-radius:12px; font-size:12px;\">Enterprise</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>organizations:groups:read</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Read organization user group information, user group members.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e0f7fa; color:#006064; padding:2px 8px; border-radius:12px; font-size:12px;\">Enterprise</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>organizations:groups:write</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Modify organization user group information, user group members.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e0f7fa; color:#006064; padding:2px 8px; border-radius:12px; font-size:12px;\">Enterprise</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>projects:read</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Retrieve project information, such as the list of projects, project settings, and project members.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n        <span style=\"background-color:#fbe9e7; color:#bf360c; padding:2px 8px; border-radius:12px; font-size:12px;\">REST API</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>projects:write</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Create or delete projects, update project information, project settings, and project members.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e8f5e9; color:#1b5e20; padding:2px 8px; border-radius:12px; font-size:12px;\">Web SDK</span>\n        <span style=\"background-color:#fbe9e7; color:#bf360c; padding:2px 8px; border-radius:12px; font-size:12px;\">REST API</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>contentlogs:export</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Export all activity on all boards within your organization.</td>\n        <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#f3e5f5; color:#4a148c; padding:2px 8px; border-radius:12px; font-size:12px;\">Enterprise Guard</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>boards:export</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">Export boards within your organization as PDF with comments and talktrack.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e0f7fa; color:#006064; padding:2px 8px; border-radius:12px; font-size:12px;\">Enterprise</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#FFFFFF; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>sessions:delete</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">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.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#e0f7fa; color:#006064; padding:2px 8px; border-radius:12px; font-size:12px;\">Enterprise</span>\n      </td>\n    </tr>\n    <tr style=\"background-color:#F9F9F9; color:#333;\">\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\"><strong>organizations:cases:management</strong></td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0;\">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.</td>\n      <td style=\"padding:10px; border:1px solid #E0E0E0; text-align:center;\">\n        <span style=\"background-color:#f3e5f5; color:#4a148c; padding:2px 8px; border-radius:12px; font-size:12px;\">Enterprise Guard</span>\n      </td>\n    </tr>\n  </tbody>\n</table>\n"
}
[/block]

# Sibling pages

* [Introduction](https://developers.miro.com/miro-ea/reference/overview.md)
* [Rate limiting](https://developers.miro.com/miro-ea/reference/rate-limiting.md)
* [Authorization flow for expiring tokens](https://developers.miro.com/miro-ea/reference/authorization-flow-for-expiring-tokens.md)
* [Authorization flow for non-expiring access tokens](https://developers.miro.com/miro-ea/reference/authorization-flow-for-expiring-access-tokens.md)