Miro Collection
Miro Collection Integration with Onna
Overview
This guide explains how to set up and interact with a Miro collection through the Onna Platform API. You'll learn how to create a workspace and collection, authorize access to Miro via OAuth2, list the users available in the Miro organization, configure sync filters to control exactly which users are synchronized, start the sync, and clean up your environment afterward.
Create a workspace
A workspace is the main container for your project in Onna. Create one with a POST request.
curl --location --request POST 'https://api.onna.com/v1/workspaces' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "My New Workspace",
"description": "This is a workspace for organizing Miro data in Onna."
}'
Where:
nameis the name of the workspace.descriptionis a brief description of the workspace's purpose.
A successful response (201) will return:
{
"onna_id": "<WORKSPACE_ID>"
}
Create a Miro Wallet
Miro credentials are stored in a wallet that the collection references. Create an empty wallet first; the OAuth pairing step later populates it with the access token.
curl --location --request POST 'https://api.onna.com/v1/wallet' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Miro",
"credential_type_name": "Datasource",
"config_type": "miro"
}'
Where:
nameis a label for the wallet.credential_type_nameis the credential type. For Miro, useDatasource.config_typeidentifies the service the wallet holds credentials for. For Miro, usemiro.
A successful response (201) will return:
{
"onna_id": "<WALLET_ID>"
}