Mural
Overview
Pre-built tooling
✅ Authorization
| Tools | Status |
|---|---|
| Pre-built authorization (OAuth) | ✅ |
| Credentials auto-refresh | ✅ |
| Auth parameters validation | ✅ |
| Pre-built authorization UI | ✅ |
| Custom authorization UI | ✅ |
| Expired credentials detection | ✅ |
✅ Read & write data
| Tools | Status |
|---|---|
| Pre-built integrations | ✅ |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Tenklo on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) |
| Proxy requests | ✅ |
✅ 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 | ✅ |
✅ 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 | Source code |
|---|---|---|---|
create-mural-from-template | Create a new mural pre-populated with a template layout/content. | Action | 🔗 Github |
create-mural-tag | Create a new tag on a mural. | Action | 🔗 Github |
create-mural | Create a new, empty mural inside a room. | Action | 🔗 Github |
create-room-folder | Create a folder inside a room, to further organize murals. | Action | 🔗 Github |
create-room | Create a room in a workspace. | Action | 🔗 Github |
create-shapes | Create one or more shape widgets on a mural canvas. | Action | 🔗 Github |
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. | Action | 🔗 Github |
create-text-boxes | Create one or more text box widgets on a mural. | Action | 🔗 Github |
delete-mural-tag | Permanently delete a tag from a mural. | Action | 🔗 Github |
delete-mural-widget | Permanently delete a single widget from a mural, regardless of its type. | Action | 🔗 Github |
delete-mural | Permanently delete a mural. HARD delete - no recycle bin, no restore. | Action | 🔗 Github |
delete-room-folder | Delete a folder inside a room. | Action | 🔗 Github |
delete-room-safely | Safely delete a room, refusing to cascade-delete its murals unless explicitly confirmed. | Action | 🔗 Github |
delete-room | Permanently delete a room and every mural it currently contains. | Action | 🔗 Github |
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. | Action | 🔗 Github |
duplicate-mural | Duplicate an existing mural, including its widgets, into a target room with a new title. | Action | 🔗 Github |
export-mural | Start an export of a mural to a downloadable file and return the export job id. | Action | 🔗 Github |
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. | Action | 🔗 Github |
get-current-user | Get the profile of the user this connection authenticates as. | Action | 🔗 Github |
get-mural-export | Check the status of a previously-started mural export and get its (time-limited) download URL once ready. | Action | 🔗 Github |
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. | Action | 🔗 Github |
get-mural-tag | Retrieve a single tag from a mural by ID. | Action | 🔗 Github |
get-mural-widget | Retrieve a single widget by ID. | Action | 🔗 Github |
get-mural | Retrieve a single mural's full details by ID. | Action | 🔗 Github |
get-room | Retrieve a single room by ID. | Action | 🔗 Github |
get-workspace | Retrieve a single workspace by ID, including who created it. | Action | 🔗 Github |
invite-mural-members | Invite one or more people (by email) to a specific mural with a view or edit permission level. | Action | 🔗 Github |
invite-room-members | Invite one or more people (by email) to join a room. | Action | 🔗 Github |
list-mural-members | List the members and guests who have access to a specific mural, including facilitator and owner permission flags. | Action | 🔗 Github |
list-mural-tags | List the tags defined on a mural. | Action | 🔗 Github |
list-mural-widgets | List every widget (sticky note, text, shape, image, etc.) on a mural canvas. | Action | 🔗 Github |
list-open-rooms | List only the open rooms in a workspace (rooms any workspace member can join, as opposed to invitation-only private rooms). | Action | 🔗 Github |
list-recent-murals | List the murals most recently opened by the authenticated user in a workspace. | Action | 🔗 Github |
list-recent-templates | List templates this connection's user has recently used in a workspace. | Action | 🔗 Github |
list-room-folders | List the folders that exist inside a room. | Action | 🔗 Github |
list-room-members | List the members who have access to a room. | Action | 🔗 Github |
list-room-murals | List the murals that live directly inside a specific room. | Action | 🔗 Github |
list-workspace-murals | List every mural across an entire workspace (all rooms). | Action | 🔗 Github |
list-workspace-rooms | List every room (folder/container) in a workspace. | Action | 🔗 Github |
list-workspace-templates | List the mural templates available to a workspace, including Mural's default/shared library. | Action | 🔗 Github |
list-workspaces | List the workspaces this connection can access (top-level org units in Mural's object model). | Action | 🔗 Github |
search-murals | Search murals in a workspace by title, optionally scoped to a room. | Action | 🔗 Github |
search-rooms | Search rooms in a workspace by name. | Action | 🔗 Github |
search-templates | Full-text search for templates by name, scoped to a workspace. | Action | 🔗 Github |
update-mural-member-permissions | Update a mural member's facilitator permission flag. | Action | 🔗 Github |
update-mural-tag | Update a tag's text or color. | Action | 🔗 Github |
update-mural | Update a mural's title, background color, or dimensions. Partial merge. | Action | 🔗 Github |
update-room | Update a room name or description (partial merge). | Action | 🔗 Github |
update-shape | Update an existing shape widget's position, size, text, or style. | Action | 🔗 Github |
update-sticky-note | Update an existing sticky note in a mural. | Action | 🔗 Github |
update-text-box | Update an existing text widget on a mural. | Action | 🔗 Github |
mural-widgets | Sync every widget across every mural in the workspace. | Sync | 🔗 Github |
murals | Sync every mural in the workspace (title, room, status, sharing/visitor settings, timestamps). | Sync | 🔗 Github |
rooms | Sync every room in every accessible Mural workspace. | Sync | 🔗 Github |
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ |
Setup guide
No setup guide yet.
Need help getting started? Get help in the community.
Contribute improvements to the setup guide by editing this page
Useful links
- How to register an Application
- OAuth-related docs
- List of OAuth scopes
- Web API docs (their REST API)
Contribute useful links by editing this page
API gotchas
Contribute API gotchas by editing this page