> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mural

> Mural is a digital whiteboard platform enabling distributed teams to visually brainstorm, map ideas, and collaborate in real time with sticky notes and diagrams

![Mural logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/mural.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=935643fe5d3a31cc13fe8d08a6bcd71d)

* **Category:** team collaboration
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 40
* **Triggers:** 0
* **Slug:** `MURAL`
* **Version:** 20261101\_00

## Tools

> [accordion] MURAL Authorization Request
>
> **Slug:** `MURAL_AUTHORIZATION_REQUEST`
>
> Tool to initiate the OAuth 2.0 authorization process. Use when you need to redirect a user to Mural to obtain an authorization code.
>
> #### Input Parameters
>
> **scope** `array` *required*
>
> List of permission scopes to request. Provided as a list of strings; they will be joined with spaces in the URL.
>
> **state** `string`
>
> Optional opaque value sent and returned in the callback to prevent CSRF and correlate requests.
>
> **client\_id** `string` *required*
>
> The client identifier for your Mural app (provided when registering your app).
>
> **redirect\_uri** `string` *required*
>
> The callback URL where users are redirected after granting access. Must match one of your app's registered redirect URLs.
>
> **response\_type** `string`
>
> Grant type for authorization code flow; must be 'code'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create area
>
> **Slug:** `MURAL_CREATE_AREA`
>
> Create an area widget that can organize content on a mural.
>
> #### Input Parameters
>
> **x** `number`
>
> Horizontal position of the area in pixels.
>
> **y** `number`
>
> Vertical position of the area in pixels.
>
> **style** `object`
>
> Optional styling for a new area widget.
>
> **title** `string`
>
> Area title shown on the mural and in the outline.
>
> **width** `number`
>
> Area width in pixels.
>
> **height** `number`
>
> Area height in pixels.
>
> **hidden** `boolean`
>
> Whether the area is hidden from non-facilitators in the outline.
>
> **layout** `string ("free" | "column" | "row")`
>
> Layout used to arrange widgets in the area.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **parentId** `string`
>
> Identifier of the parent area widget.
>
> **showTitle** `boolean`
>
> Whether the area title is displayed.
>
> **instruction** `string`
>
> Facilitator instructions for the area in the outline.
>
> **stackingOrder** `number`
>
> Z-index stacking order of the area.
>
> **presentationIndex** `number`
>
> List order of the area in the outline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create arrow
>
> **Slug:** `MURAL_CREATE_ARROW`
>
> Create one arrow widget on a mural.
>
> #### Input Parameters
>
> **x** `number` *required*
>
> Horizontal position of the arrow in pixels.
>
> **y** `number` *required*
>
> Vertical position of the arrow in pixels.
>
> **tip** `string ("no tip" | "single" | "double")`
>
> Arrow tip type. Defaults to single.
>
> **label** `object`
>
> Arrow label and its formatting.
>
> **style** `object`
>
> Connector stroke styling.
>
> **title** `string`
>
> Arrow title in the mural outline.
>
> **width** `number` *required*
>
> Width of the arrow in pixels.
>
> **height** `number` *required*
>
> Height of the arrow in pixels.
>
> **points** `array` *required*
>
> At least two points defining the connector path.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **endRefId** `string`
>
> Widget ID connected to the arrow's end point.
>
> **parentId** `string`
>
> ID of the containing area widget.
>
> **rotation** `number`
>
> Clockwise rotation in degrees from 0 up to, but not including, 360.
>
> **arrowType** `string ("straight" | "curved" | "orthogonal")`
>
> Arrow line type. Defaults to straight.
>
> **stackable** `boolean`
>
> Whether the arrow can be stacked. Defaults to true.
>
> **startRefId** `string`
>
> Widget ID connected to the arrow's start point.
>
> **instruction** `string`
>
> Facilitator instructions for the outline section.
>
> **stackingOrder** `number`
>
> Z-index stacking order of the arrow.
>
> **presentationIndex** `number`
>
> Position in the mural outline. Defaults to -1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create asset upload
>
> **Slug:** `MURAL_CREATE_ASSET`
>
> Create a signed upload target for an image or file attached to a mural.
>
> #### Input Parameters
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **assetType** `string ("image" | "file")`
>
> Type of asset that will be uploaded. Defaults to file.
>
> **fileExtension** `string` *required*
>
> File extension for the asset, without a leading period.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Image
>
> **Slug:** `MURAL_CREATE_IMAGE`
>
> Create an image widget from an uploaded Mural asset name.
>
> #### Input Parameters
>
> **x** `number` *required*
>
> Horizontal position in pixels.
>
> **y** `number` *required*
>
> Vertical position in pixels.
>
> **name** `string` *required*
>
> Asset name returned after creating and uploading a Mural image asset.
>
> **width** `number` *required*
>
> Width of the image widget in pixels.
>
> **border** `boolean`
>
> Whether a black border is displayed around the image.
>
> **height** `number` *required*
>
> Height of the image widget in pixels.
>
> **hidden** `boolean`
>
> Whether the widget is hidden from non-facilitators in the outline.
>
> **caption** `string`
>
> Caption and outline title.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **parentId** `string`
>
> ID of the containing area widget.
>
> **rotation** `number`
>
> Rotation in degrees from 0 up to, but not including, 360.
>
> **hyperlink** `string`
>
> URL opened from the image widget.
>
> **description** `string`
>
> Image caption description.
>
> **instruction** `string`
>
> Facilitator instructions for the outline section.
>
> **showCaption** `boolean`
>
> Whether the caption and description are displayed.
>
> **stackingOrder** `number`
>
> Z-index stacking order of the image widget.
>
> **presentationIndex** `number`
>
> Position of the image widget in the mural outline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create mural
>
> **Slug:** `MURAL_CREATE_MURAL`
>
> Create a new blank mural in a room owned by the connected user.
>
> #### Input Parameters
>
> **title** `string`
>
> Title of the mural.
>
> **width** `number`
>
> Canvas width in pixels.
>
> **height** `number`
>
> Canvas height in pixels.
>
> **roomId** `integer` *required*
>
> Unique identifier of the room.
>
> **folderId** `string`
>
> UUID of the folder that will contain the mural.
>
> **infinite** `boolean`
>
> Whether the canvas is borderless and grows with its content.
>
> **backgroundColor** `string`
>
> Canvas color in #RRGGBBAA format.
>
> **timerSoundTheme** `string ("airplane" | "cello" | "cuckoo")`
>
> Timer sound theme for the mural.
>
> **visitorsSettings** `object`
>
> Visitor-link settings for a new mural.
>
> **visitorAvatarTheme** `string ("animals" | "music" | "travel")`
>
> Visitor avatar theme for the mural.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create mural from template
>
> **Slug:** `MURAL_CREATE_MURAL_FROM_TEMPLATE`
>
> Create a new mural in a room using an existing template.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Title for the new mural.
>
> **roomId** `integer` *required*
>
> Unique identifier of the destination room.
>
> **folderId** `string`
>
> Unique identifier of the destination folder.
>
> **templateId** `string` *required*
>
> Unique identifier of the template to instantiate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create shapes
>
> **Slug:** `MURAL_CREATE_SHAPES`
>
> Create between one and 1000 shape widgets on a mural in one request.
>
> #### Input Parameters
>
> **shapes** `array` *required*
>
> Shapes to create as a direct array. Supply between 1 and 1000 items.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create sticky note
>
> **Slug:** `MURAL_CREATE_STICKY_NOTE`
>
> Create up to 1000 sticky note widgets on a mural in one request.
>
> #### Input Parameters
>
> **muralId** `string` *required*
>
> Unique identifier of the mural
>
> **stickies** `array` *required*
>
> Array of sticky note objects to create. Each object must have 'x' and 'y' coordinates. Pass objects directly, not strings or nested structures. Maximum 1000 items.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create text boxes
>
> **Slug:** `MURAL_CREATE_TEXTBOX`
>
> Create up to 1000 text box widgets on a mural.
>
> #### Input Parameters
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **textboxes** `array` *required*
>
> Text boxes to create as a direct array. Maximum 1000 items.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create title widgets
>
> **Slug:** `MURAL_CREATE_TITLE_WIDGETS`
>
> Create up to 1000 title widgets on a mural.
>
> #### Input Parameters
>
> **titles** `array` *required*
>
> Title widget definitions sent as a direct array. Maximum 1000 items.
>
> **muralId** `string` *required*
>
> Unique identifier of the destination mural.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete widget
>
> **Slug:** `MURAL_DELETE_WIDGET`
>
> Permanently delete a widget and its content from a mural.
>
> #### Input Parameters
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **widgetId** `string` *required*
>
> Unique identifier of the widget to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Export Mural
>
> **Slug:** `MURAL_EXPORT_MURAL`
>
> Queue a mural export to a PDF file and return its export process ID.
>
> #### Input Parameters
>
> **muralId** `string` *required*
>
> Unique identifier of the mural to export.
>
> **downloadFormat** `string` *required*
>
> File extension for the export. MURAL currently supports 'pdf'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get current user
>
> **Slug:** `MURAL_GET_CURRENT_USER`
>
> Tool to retrieve information about the currently authenticated user. Use when you need current user details after authentication.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get files for a mural
>
> **Slug:** `MURAL_GET_FILES_FOR_MURAL`
>
> Tool to retrieve a list of file widgets in a mural. Use after confirming the mural ID when listing file attachments.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for next page of items
>
> **limit** `integer`
>
> Maximum number of results to return
>
> **muralId** `string` *required*
>
> Unique identifier of the mural
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get mural
>
> **Slug:** `MURAL_GET_MURAL`
>
> Retrieve metadata for a mural by its unique identifier.
>
> #### Input Parameters
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Mural Widgets
>
> **Slug:** `MURAL_GET_MURAL_WIDGETS`
>
> Retrieve widgets within a specified mural, including sticky notes, text boxes, shapes, images, areas, arrows, icons, files, and comments; drawings are not currently included. Supports filtering by widget type and parent container, and pagination.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token from previous response to retrieve the next page of results.
>
> **type** `array`
>
> List of widget types to filter by (e.g., \['area', 'sticky note']). When omitted, returns all widget types.
>
> **limit** `integer`
>
> Maximum number of widgets to return per page (must be ≥1). Use with 'next' for pagination.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **parentId** `string`
>
> Filter to return only widgets contained within the specified parent widget ID (typically an area widget).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get room by ID
>
> **Slug:** `MURAL_GET_ROOM`
>
> Tool to retrieve information about a specific room by its ID. Use when you need details about a particular room that the authenticated user has read access to.
>
> #### Input Parameters
>
> **roomId** `string` *required*
>
> Unique identifier of the room to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get widget
>
> **Slug:** `MURAL_GET_WIDGET`
>
> Get one widget by its mural and widget identifiers.
>
> #### Input Parameters
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **widgetId** `string` *required*
>
> Unique identifier of the widget.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get workspace by ID
>
> **Slug:** `MURAL_GET_WORKSPACE`
>
> Tool to retrieve information about a specific workspace by its ID. Use when you need details about a particular workspace that the authenticated user has read access to.
>
> #### Input Parameters
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get workspaces
>
> **Slug:** `MURAL_GET_WORKSPACES`
>
> Tool to retrieve all workspaces the authenticated user is a member of. Use to list available workspaces before accessing rooms or murals.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of workspaces to return per page (must be ≥1)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List folders in room
>
> **Slug:** `MURAL_LIST_FOLDERS`
>
> Tool to list all folders within a room that the authenticated user has access to. Use after MURAL\_LIST\_ROOMS to navigate folders within a specific room.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of folders to return per page (must be ≥1)
>
> **roomId** `string` *required*
>
> Unique identifier of the room to list folders from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List open rooms in workspace
>
> **Slug:** `MURAL_LIST_OPEN_ROOMS`
>
> Tool to list all discoverable open rooms within a workspace. Use when you need to access publicly available rooms in a workspace that don't require specific membership.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of rooms to return per page (must be ≥1)
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to list open rooms from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List recent murals in workspace
>
> **Slug:** `MURAL_LIST_RECENT_MURALS`
>
> Tool to list recently opened active murals for the authenticated user in a workspace. Use after MURAL\_LIST\_WORKSPACES to view recent murals before opening or editing them.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of murals to return per page (must be ≥1)
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to list recent murals from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List recent templates
>
> **Slug:** `MURAL_LIST_RECENT_TEMPLATES`
>
> Tool to retrieve recent templates used by a user for a workspace. Use when you need to access recently used templates for creating new murals.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of templates to return per page (must be ≥1)
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to list recent templates from
>
> **withoutDefault** `boolean`
>
> If true, the list of returned templates will not include default templates
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List murals in room
>
> **Slug:** `MURAL_LIST_ROOM_MURALS`
>
> Tool to list all murals for a room that the authenticated user has read access to. Use after getting a room ID to retrieve murals within that room.
>
> #### Input Parameters
>
> **next** `string`
>
> Token to get the next page of items
>
> **limit** `integer`
>
> Maximum number of results to be returned by the endpoint
>
> **roomId** `integer` *required*
>
> Unique identifier of the room to list murals from
>
> **sortBy** `string ("lastCreated" | "lastModified" | "oldest")`
>
> Sort order options for murals.
>
> **status** `string ("active" | "archived")`
>
> Status filter for murals.
>
> **folderId** `string`
>
> When set, filter murals by their corresponding folder
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List rooms in workspace
>
> **Slug:** `MURAL_LIST_ROOMS`
>
> List rooms in a workspace that the authenticated user can read. The user must have access to both the workspace and the rooms.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of rooms to return per page (must be ≥1)
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to list rooms from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List users in room
>
> **Slug:** `MURAL_LIST_ROOM_USERS`
>
> Tool to list all members and guests for a room. Returns users that the authenticated user has access to view. Use after LIST\_ROOMS to get room membership details.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of users to return per page (must be ≥1)
>
> **roomId** `string` *required*
>
> Unique identifier of the room to list users from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List tags in a mural
>
> **Slug:** `MURAL_LIST_TAGS`
>
> Tool to retrieve all tags in a mural. Use when you need to list or view tags associated with a specific mural.
>
> #### Input Parameters
>
> **muralId** `string` *required*
>
> Unique identifier of a mural
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List default templates
>
> **Slug:** `MURAL_LIST_TEMPLATES`
>
> Tool to retrieve all default templates available in Mural. Use when you need to browse or select from standard Mural templates.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of templates to return per page (must be ≥1)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List workspace murals
>
> **Slug:** `MURAL_LIST_WORKSPACE_MURALS`
>
> Tool to list all murals in a workspace that the authenticated user owns or is a member of. Use after getting a workspace ID to browse available murals.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of murals to return per page (must be ≥1)
>
> **sortBy** `string ("lastCreated" | "lastModified" | "oldest")`
>
> Sort order for murals.
>
> **status** `string ("active" | "archived")`
>
> Status filter for murals.
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to list murals from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List workspace templates
>
> **Slug:** `MURAL_LIST_WORKSPACE_TEMPLATES`
>
> Tool to get default and custom templates for a workspace. Use when you need to list available templates after authentication.
>
> #### Input Parameters
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of templates to return per page (must be ≥1)
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to list templates from
>
> **withoutDefault** `boolean`
>
> If true, the list of returned templates will not include default templates
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search murals in workspace
>
> **Slug:** `MURAL_SEARCH_MURALS`
>
> Tool to search for murals within a workspace. Returns all murals that the authenticated user owns or is a member of for the specified workspace. Use when searching for specific murals by query text.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> The text this search query is for
>
> **next** `string`
>
> Token to get the next page of items
>
> **limit** `integer`
>
> Maximum number of results to be returned by the endpoint (must be ≥1)
>
> **roomId** `integer`
>
> Unique identifier of a room. When provided, restrict the results to murals in the specified room.
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to search murals in
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search rooms in workspace
>
> **Slug:** `MURAL_SEARCH_ROOMS`
>
> Tool to search for rooms within a workspace by name or description. Returns all rooms that the authenticated user owns or is a member of matching the query. Use when you need to find specific rooms by search text.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> The search query text to filter rooms by name or description
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of rooms to return per page (must be ≥1)
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to search rooms from
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search templates in workspace
>
> **Slug:** `MURAL_SEARCH_TEMPLATES`
>
> Search custom templates within a workspace that the authenticated user owns or has access to, using a name or keyword query.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> The text search query for finding templates
>
> **next** `string`
>
> Pagination token for retrieving the next page of results
>
> **limit** `integer`
>
> Maximum number of templates to return per page (must be ≥1)
>
> **workspaceId** `string` *required*
>
> Unique identifier of the workspace to search templates in
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update area
>
> **Slug:** `MURAL_UPDATE_AREA`
>
> Update documented properties of an existing area widget on a mural.
>
> #### Input Parameters
>
> **x** `number`
>
> Horizontal position in pixels.
>
> **y** `number`
>
> Vertical position in pixels.
>
> **style** `object`
>
> Style properties that can be changed on an area widget.
>
> **title** `string`
>
> Title shown for the area.
>
> **width** `number`
>
> Width of the area in pixels.
>
> **height** `number`
>
> Height of the area in pixels.
>
> **hidden** `boolean`
>
> Whether the area is hidden from non-facilitators in the outline.
>
> **layout** `string ("free" | "column" | "row")`
>
> Layout applied to widgets inside the area.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **parentId** `string`
>
> Identifier of the parent area widget.
>
> **widgetId** `string` *required*
>
> Unique identifier of the area widget.
>
> **showTitle** `boolean`
>
> Whether the area title is displayed.
>
> **instruction** `string`
>
> Facilitator-managed instructions for the outline section.
>
> **presentationIndex** `number`
>
> Position of the area in the outline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update arrow
>
> **Slug:** `MURAL_UPDATE_ARROW`
>
> Update documented properties of an existing arrow widget on a mural.
>
> #### Input Parameters
>
> **x** `number`
>
> Horizontal position in pixels.
>
> **y** `number`
>
> Vertical position in pixels.
>
> **tip** `string ("no tip" | "single" | "double")`
>
> Arrow tip type.
>
> **label** `object`
>
> Arrow label and its formatting.
>
> **style** `object`
>
> Connector stroke styling.
>
> **title** `string`
>
> Arrow title in the mural outline.
>
> **width** `number`
>
> Width of the arrow in pixels.
>
> **height** `number`
>
> Height of the arrow in pixels.
>
> **points** `array`
>
> At least two points defining the connector path.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **endRefId** `string`
>
> Widget ID connected to the arrow's end point.
>
> **parentId** `string`
>
> ID of the containing area widget.
>
> **rotation** `number`
>
> Clockwise rotation in degrees from 0 up to, but not including, 360.
>
> **widgetId** `string` *required*
>
> Unique identifier of the arrow widget.
>
> **arrowType** `string ("straight" | "curved" | "orthogonal")`
>
> Arrow line type.
>
> **stackable** `boolean`
>
> Whether the arrow can be stacked.
>
> **startRefId** `string`
>
> Widget ID connected to the arrow's start point.
>
> **instruction** `string`
>
> Facilitator instructions for the outline section.
>
> **presentationIndex** `number`
>
> Position of the arrow in the mural outline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update shape
>
> **Slug:** `MURAL_UPDATE_SHAPE`
>
> Update documented properties of an existing shape widget on a mural.
>
> #### Input Parameters
>
> **x** `number`
>
> Horizontal position in pixels.
>
> **y** `number`
>
> Vertical position in pixels.
>
> **text** `string`
>
> Plain text shown in the shape.
>
> **style** `object`
>
> Style properties that can be changed on a shape widget.
>
> **title** `string`
>
> Title shown in the outline.
>
> **width** `number`
>
> Width of the shape in pixels.
>
> **height** `number`
>
> Height of the shape in pixels.
>
> **hidden** `boolean`
>
> Whether the shape is hidden from non-facilitators in the outline.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **htmlText** `string`
>
> Shape text with supported inline HTML formatting.
>
> **parentId** `string`
>
> Identifier of the parent area widget.
>
> **rotation** `number`
>
> Rotation angle in degrees from 0 up to, but not including, 360.
>
> **widgetId** `string` *required*
>
> Unique identifier of the shape widget.
>
> **instruction** `string`
>
> Facilitator-managed instructions for the outline section.
>
> **presentationIndex** `number`
>
> Position of the shape in the outline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update sticky note
>
> **Slug:** `MURAL_UPDATE_STICKY_NOTE`
>
> Update documented properties of an existing sticky-note widget on a mural.
>
> #### Input Parameters
>
> **x** `number`
>
> Horizontal position in pixels.
>
> **y** `number`
>
> Vertical position in pixels.
>
> **tags** `array`
>
> Unique identifiers of tags assigned to the widget.
>
> **text** `string`
>
> Plain text displayed in the widget.
>
> **style** `object`
>
> Style properties that can be changed on a sticky-note widget.
>
> **title** `string`
>
> Widget title in the mural outline.
>
> **width** `number`
>
> Width of the widget in pixels.
>
> **height** `number`
>
> Height of the widget in pixels.
>
> **hidden** `boolean`
>
> Whether the widget is hidden from non-facilitators in the outline.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **htmlText** `string`
>
> Text with supported inline HTML formatting.
>
> **parentId** `string`
>
> ID of the containing area widget.
>
> **rotation** `number`
>
> Rotation in degrees from 0 up to, but not including, 360.
>
> **widgetId** `string` *required*
>
> Unique identifier of the sticky-note widget.
>
> **hyperlink** `string`
>
> URL used in the widget.
>
> **instruction** `string`
>
> Facilitator instructions for the outline section.
>
> **hyperlinkTitle** `string`
>
> Text displayed on the hyperlink button.
>
> **presentationIndex** `number`
>
> Position of the widget in the mural outline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Textbox
>
> **Slug:** `MURAL_UPDATE_TEXTBOX`
>
> Partially update a textbox widget's content, style, size, or position.
>
> #### Input Parameters
>
> **x** `number`
>
> Horizontal position in pixels.
>
> **y** `number`
>
> Vertical position in pixels.
>
> **text** `string`
>
> Text displayed in the widget.
>
> **style** `object`
>
> Textbox style properties accepted by MURAL's update endpoint.
>
> **title** `string`
>
> Widget title in the outline.
>
> **width** `number`
>
> Width of the widget in pixels.
>
> **height** `number`
>
> Height of the widget in pixels.
>
> **hidden** `boolean`
>
> Whether the widget is hidden from non-facilitators when it is in the outline.
>
> **muralId** `string` *required*
>
> Unique identifier of the mural.
>
> **parentId** `string`
>
> ID of the area widget that contains this widget.
>
> **rotation** `number`
>
> Widget rotation in degrees, from 0 inclusive to 360 exclusive.
>
> **widgetId** `string` *required*
>
> Unique identifier of the textbox widget.
>
> **hyperlink** `string`
>
> URL used in the widget, up to 1024 characters.
>
> **instruction** `string`
>
> Facilitator instructions for the widget in the outline.
>
> **hyperlinkTitle** `string`
>
> Text displayed on the hyperlink button.
>
> **presentationIndex** `number`
>
> List order of the widget in the outline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
