2025-09-25
Password-protected board access for Platform API
We've added a new security feature to enhance board privacy and access control through the Miro Platform API. The accessPasswordRequired
field is now available as a read-only field in the Get boards API endpoint which returns the current password requirement status when retrieving board information.
Field details:
- Type:
boolean
- Default value:
false
- Location:
policy.sharingPolicy.accessPasswordRequired
Note
This field is not available in POST or PATCH operations. Password protection settings must be configured through the Miro web interface.
Example response
Retrieving board information with password protection status:
{
"id": "uXjVO055jdcvP4D5jf2ibN0efUh=",
"name": "Confidential Project Board",
"policy": {
"sharingPolicy": {
"access": "view",
"accessPasswordRequired": true,
"inviteToAccountAndBoardLinkAccess": "no_access"
}
}
}
Benefits
- Programmatic visibility: Determine if a board requires password access when integrating with Miro.
- Enhanced security awareness: Applications can now detect password-protected boards.
- Backward compatibility: Defaults to
false
to maintain existing behavior.
Migration notes
This is a non-breaking change. Existing applications will continue to work without modifications, and the field will default to false
for all existing boards.
For applications that want to leverage this new security feature, include the accessPasswordRequired
field in your board policy configurations.