API

Turn your Miro Mind Map into a live API endpoint

The new API feature allows you to generate a direct CSV download URL from your Miro Mind Map data. This URL can act as an API endpoint, enabling seamless integration with other tools and workflows, from updating databases to triggering automated reports. Follow the steps below to start using this feature effectively.

Overview

With the API feature, you can create a live CSV download URL for your Mind Map data. This can be a new URL or an update to an existing one if your Mind Map changes. This live link makes it easier to share, download, or directly integrate Mind Map data into other systems.

Selecting the API File Type

1. From the File Type dropdown in Mind Map Downloader, select API.

2. You’ll see options to either Create a New Endpoint or Update an Existing Endpoint.

Create or Update API endpoints with the 'API' feature.

Creating a New API Endpoint

To set up a new endpoint:

1. Select API as your file type in the Mind Map Downloader.

2. Choose Create New Endpoint.

3. In the Endpoint Name field, enter a unique name for your endpoint.

   • Use all lowercase letters, and replace spaces with hyphens (e.g., my-mindmap-endpoint).

   • Special characters are not allowed.

4. Select the center node of your Mind Map as usual with Mind Map Downloader.

5. Click Load Export.

6. Click Create API Endpoint.

Updating an Existing API Endpoint

To update an existing endpoint:

1. Select API as your file type in the Mind Map Downloader.

2. Choose Update Existing Endpoint.

3. From the dropdown, select the endpoint you want to update.

4. Select the center node of your Mind Map.

5. Click Load Export.

6. Click Update API Endpoint.

Using the API Endpoint

Your API endpoint URLs follow this format:

https://api.miromindmap/<unique-user-id>/<endpoint-name>

When you create or update an endpoint, a confirmation alert will display the new URL.

An alert will display your API endpoint

You can also view any existing URL by selecting Update Existing Endpoint and choosing your endpoint from the dropdown, then clicking Show API Endpoint URL.

You can test your URL in a browser or with a tool like Postman.

Important Notes

• Automatic Formatting: The Endpoint Name field automatically converts input to lowercase, replaces spaces with hyphens, and removes special characters.

• Unique Name Requirement: If the entered name already exists, the feature will recognize it as an update rather than creating a new endpoint.

• Security: Each API endpoint URL includes a unique identifier tied to your Miro account. This ensures the security of your data.

• Storage: The API feature will require your Mind Map data to be stored in our systems. This is done to an industry standard with the latest end-to-end encryption.

If you have any questions about these API endpoints, please contact our support team.