Add permission scopes to your app

The Miro REST API and the Miro Web SDK implement user access control through permission scopes.

Scopes limit app access to user data. They enable selecting only specific data subsets, depending on the user resources that the app needs to work as expected.

Goal

Set the minimum required set of permissions that users need to grant an app so that they can interact with it.

Prerequisites

Before you begin, make sure that:

• You have a Miro account.
• You're signed in to Miro.
• Your Miro account has a Developer team.

Add permission scopes to your app

To request permissions for an app:

1. Go to your Profile settings.
2. Click Your apps.
3. Select the app whose permissions you want to update to display its app settings.
4. On the app settings page, browse to Permissions, and then select the checkboxes corresponding to the scopes that your app requires to work.

Figure 1. Select the checkboxes corresponding to the permissions that users need to grant your app.

When users install the app, or when they click the app icon to use the app for the first time, they are prompted to grant the app the specified permissions.

Figure 2. Users need to give their explicit consent to enable the permissions that the app requests.

See also

• Miro Web SDK and REST API permission scopes
• Access token scope
• OAuth scope