> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parable.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Miro

> Connect Parable to Miro to sync boards, board items, members, tags, connectors, groups, and enterprise features including organization members, teams, and audit logs.

<img className="connector-logo" src="https://img.logo.dev/miro.com?token=pk_N2gy3fJKQ0aldg9QTg7cHA" alt="Miro logo" />

# Miro Connectors

Connect Parable to Miro to ingest collaboration data across boards, board items (sticky notes, shapes, cards, text, frames, and more), board members, tags, groups, and connectors. Enterprise plan customers can also ingest organization members, teams, and audit logs.

<CardGroup cols={2}>
  <Card title="Bearer Token" icon="key" href="/connectors/miro/bearer-token/setup">
    Non-expiring access token from your Miro Developer Portal app.
  </Card>
</CardGroup>

## Authentication Overview

Miro supports two credential types. Parable currently uses **non-expiring bearer tokens**:

* **Non-expiring bearer token** -- a static token generated in the Miro Developer Portal when creating an app with the non-expiring token option. Does not expire and does not require token refresh. This is the supported auth strategy for v1.
* **OAuth 2.0** -- short-lived access token (1 hour) plus refresh token (60 days). Requires a browser-based authorization flow per user. Supported in a future release.

<Warning>
  Non-expiring token behavior is configured at app creation time in the Miro Developer Portal and **cannot be changed afterwards**. Create a dedicated app for Parable with the non-expiring token option selected.
</Warning>

## Available Taps

| Tap                    | Description                                                         | Plan       |
| ---------------------- | ------------------------------------------------------------------- | ---------- |
| `boards`               | All boards accessible to the token                                  | Any        |
| `board_items`          | All items on each board (sticky notes, shapes, cards, frames, etc.) | Any        |
| `board_members`        | Members and roles for each board                                    | Any        |
| `board_tags`           | Tags defined on each board                                          | Any        |
| `board_connectors`     | Lines/arrows connecting items on each board                         | Any        |
| `board_groups`         | Item groups on each board                                           | Any        |
| `audit_logs`           | Organization-level audit events (incremental)                       | Enterprise |
| `organization_members` | All members of the organization                                     | Enterprise |
| `organization_teams`   | All teams within the organization                                   | Enterprise |
| `team_members`         | Members of each organization team                                   | Enterprise |

Enterprise-gated taps are disabled by default and must be explicitly enabled in the connector settings. They require an Enterprise plan and an `org_id` in the connector ingestion config.