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

# Mural

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (OAuth) | ✅ |
> | Credentials auto-refresh | ✅ |
> | Auth parameters validation | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

### Others

| Function name | Description | Type |
| - | - | - |
| `create-mural-from-template` | Create a new mural pre-populated with a template layout/content. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-mural-tag` | Create a new tag on a mural. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-mural` | Create a new, empty mural inside a room. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-room-folder` | Create a folder inside a room, to further organize murals. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-room` | Create a room in a workspace. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-shapes` | Create one or more shape widgets on a mural canvas. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-sticky-notes` | Create one or more sticky notes on a mural's canvas. Requires x/y position and a shape; everything else has sensible defaults. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-text-boxes` | Create one or more text box widgets on a mural. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-mural-tag` | Permanently delete a tag from a mural. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-mural-widget` | Permanently delete a single widget from a mural, regardless of its type. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-mural` | Permanently delete a mural. HARD delete - no recycle bin, no restore. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-room-folder` | Delete a folder inside a room. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-room-safely` | Safely delete a room, refusing to cascade-delete its murals unless explicitly confirmed. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-room` | Permanently delete a room and every mural it currently contains. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `duplicate-mural-into-room` | Composite: duplicate an existing mural into a target room identified by name, creating that room first if it does not exist. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `duplicate-mural` | Duplicate an existing mural, including its widgets, into a target room with a new title. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `export-mural` | Start an export of a mural to a downloadable file and return the export job id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `find-or-create-room-and-create-mural` | Find a room by exact name in a workspace (creating it if missing), then create a mural inside it. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-current-user` | Get the profile of the user this connection authenticates as. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-mural-export` | Check the status of a previously-started mural export and get its (time-limited) download URL once ready. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-mural-full-content` | COMPOSITE: get a mural full picture in one call - its own metadata, every widget on its canvas, its tags, and its member list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-mural-tag` | Retrieve a single tag from a mural by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-mural-widget` | Retrieve a single widget by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-mural` | Retrieve a single mural's full details by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-room` | Retrieve a single room by ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-workspace` | Retrieve a single workspace by ID, including who created it. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `invite-mural-members` | Invite one or more people (by email) to a specific mural with a view or edit permission level. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `invite-room-members` | Invite one or more people (by email) to join a room. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-mural-members` | List the members and guests who have access to a specific mural, including facilitator and owner permission flags. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-mural-tags` | List the tags defined on a mural. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-mural-widgets` | List every widget (sticky note, text, shape, image, etc.) on a mural canvas. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-open-rooms` | List only the open rooms in a workspace (rooms any workspace member can join, as opposed to invitation-only private rooms). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-recent-murals` | List the murals most recently opened by the authenticated user in a workspace. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-recent-templates` | List templates this connection's user has recently used in a workspace. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-room-folders` | List the folders that exist inside a room. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-room-members` | List the members who have access to a room. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-room-murals` | List the murals that live directly inside a specific room. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-workspace-murals` | List every mural across an entire workspace (all rooms). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-workspace-rooms` | List every room (folder/container) in a workspace. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-workspace-templates` | List the mural templates available to a workspace, including Mural's default/shared library. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-workspaces` | List the workspaces this connection can access (top-level org units in Mural's object model). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-murals` | Search murals in a workspace by title, optionally scoped to a room. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-rooms` | Search rooms in a workspace by name. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-templates` | Full-text search for templates by name, scoped to a workspace. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-mural-member-permissions` | Update a mural member's facilitator permission flag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-mural-tag` | Update a tag's text or color. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-mural` | Update a mural's title, background color, or dimensions. Partial merge. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-room` | Update a room name or description (partial merge). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-shape` | Update an existing shape widget's position, size, text, or style. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-sticky-note` | Update an existing sticky note in a mural. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-text-box` | Update an existing text widget on a mural. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `mural-widgets` | Sync every widget across every mural in the workspace. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `murals` | Sync every mural in the workspace (title, room, status, sharing/visitor settings, timestamps). | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `rooms` | Sync every room in every accessible Mural workspace. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

> [!NOTE]
>
> Nango has a [Nango-managed OAuth app](https://nango.dev/docs/guides/auth/auth-guide.md#nango-managed-oauth-apps) you can use in development and production. Select it when you create the integration.

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |

## Setup guide

*No setup guide yet.*

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/mural.mdx)

## Useful links

* [How to register an Application](https://developers.mural.co/public/docs/register-your-app)
* [OAuth-related docs](https://developers.mural.co/public/docs/oauth)
* [List of OAuth scopes](https://developers.mural.co/public/docs/scopes)
* [Web API docs (their REST API)](https://developers.mural.co/public/docs/how-to-upload-an-image-to-a-mural)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/mural.mdx)

## API gotchas

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/mural.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.