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 is a digital whiteboard platform enabling distributed teams to visually brainstorm, map ideas, and collaborate in real time with sticky notes and diagrams On Nagent, Mural is exposed as a fully-configurable team collaboration integration that any agent can call — 22 actions, and OAuth authentication. No code is required to wire Mural into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Mural to automate the kinds of tasks team collaboration teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Mural into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Mural, with input parameters and output schema. Drop these into any step of an agent built in Helix.
MURAL_AUTHORIZATION_REQUESTTool 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
List of permission scopes to request. Provided as a list of strings; they will be joined with spaces in the URL.
Optional opaque value sent and returned in the callback to prevent CSRF and correlate requests.
The client identifier for your Mural app (provided when registering your app).
The callback URL where users are redirected after granting access. Must match one of your app's registered redirect URLs.
Grant type for authorization code flow; must be 'code'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_CREATE_STICKY_NOTECreate one or more sticky note widgets on a mural. Each sticky note must be a properly structured object with required x and y coordinates. Pass the 'stickies' parameter as a direct array of objects - NOT strings, NOT nested objects. Example usage: { "muralId": "mural-id-here", "stickies": \[ {"x": 100, "y": 200, "text": "First note"}, {"x": 300, "y": 400, "text": "Second note", "shape": "circle"} \] }
Input parameters
Unique identifier of the mural
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_GET_CURRENT_USERTool to retrieve information about the currently authenticated user. Use when you need current user details after authentication.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_GET_FILES_FOR_MURALTool to retrieve a list of file widgets in a mural. Use after confirming the mural ID when listing file attachments.
Input parameters
Pagination token for next page of items
Maximum number of results to return
Unique identifier of the mural
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_GET_MURAL_WIDGETSTool to retrieve all widgets within a specified mural. Widgets include sticky notes, text boxes, shapes, images, areas, arrows, icons, files, and comments. Use this after obtaining a valid mural ID from workspace murals or other mural-related actions. Supports filtering by widget type, parent container, and pagination for large result sets.
Input parameters
Pagination token from previous response to retrieve the next page of results.
List of widget types to filter by (e.g., \['area', 'sticky note'\]). When omitted, returns all widget types.
Maximum number of widgets to return per page (must be ≥1). Use with 'next' for pagination.
Unique identifier of the mural.
Filter to return only widgets contained within the specified parent widget ID (typically an area widget).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_GET_ROOMTool 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
Unique identifier of the room to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_GET_WORKSPACETool 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
Unique identifier of the workspace to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_GET_WORKSPACESTool to retrieve all workspaces the authenticated user is a member of. Use to list available workspaces before accessing rooms or murals.
Input parameters
Pagination token for retrieving the next page of results
Maximum number of workspaces to return per page (must be ≥1)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_FOLDERSTool 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
Pagination token for retrieving the next page of results
Maximum number of folders to return per page (must be ≥1)
Unique identifier of the room to list folders from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_OPEN_ROOMSTool 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
Pagination token for retrieving the next page of results
Maximum number of rooms to return per page (must be ≥1)
Unique identifier of the workspace to list open rooms from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_RECENT_MURALSTool 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
Pagination token for retrieving the next page of results
Maximum number of murals to return per page (must be ≥1)
Unique identifier of the workspace to list recent murals from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_RECENT_TEMPLATESTool 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
Pagination token for retrieving the next page of results
Maximum number of templates to return per page (must be ≥1)
Unique identifier of the workspace to list recent templates from
If true, the list of returned templates will not include default templates
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_ROOM_MURALSTool 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
Token to get the next page of items
Maximum number of results to be returned by the endpoint
Unique identifier of the room to list murals from
Sort order options for murals.
Status filter for murals.
When set, filter murals by their corresponding folder
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_ROOMSTool to list all rooms within a workspace. Use after MURAL_LIST_WORKSPACES to navigate rooms and before MURAL_CREATE_MURAL, since murals are created within rooms.
Input parameters
Pagination token for retrieving the next page of results
Maximum number of rooms to return per page (must be ≥1)
Unique identifier of the workspace to list rooms from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_ROOM_USERSTool 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
Pagination token for retrieving the next page of results
Maximum number of users to return per page (must be ≥1)
Unique identifier of the room to list users from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_TAGSTool to retrieve all tags in a mural. Use when you need to list or view tags associated with a specific mural.
Input parameters
Unique identifier of a mural
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_TEMPLATESTool to retrieve all default templates available in Mural. Use when you need to browse or select from standard Mural templates.
Input parameters
Pagination token for retrieving the next page of results
Maximum number of templates to return per page (must be ≥1)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_WORKSPACE_MURALSTool 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
Pagination token for retrieving the next page of results
Maximum number of murals to return per page (must be ≥1)
Sort order for murals.
Status filter for murals.
Unique identifier of the workspace to list murals from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_LIST_WORKSPACE_TEMPLATESTool to get default and custom templates for a workspace. Use when you need to list available templates after authentication.
Input parameters
Pagination token for retrieving the next page of results
Maximum number of templates to return per page (must be ≥1)
Unique identifier of the workspace to list templates from
If true, the list of returned templates will not include default templates
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_SEARCH_MURALSTool 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
The text this search query is for
Token to get the next page of items
Maximum number of results to be returned by the endpoint (must be ≥1)
Unique identifier of a room. When provided, restrict the results to murals in the specified room.
Unique identifier of the workspace to search murals in
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_SEARCH_ROOMSTool 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
The search query text to filter rooms by name or description
Pagination token for retrieving the next page of results
Maximum number of rooms to return per page (must be ≥1)
Unique identifier of the workspace to search rooms from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MURAL_SEARCH_TEMPLATESTool to search templates within a workspace that the authenticated user owns or has access to. Use when you need to find specific templates by name or keyword.
Input parameters
The text search query for finding templates
Pagination token for retrieving the next page of results
Maximum number of templates to return per page (must be ≥1)
Unique identifier of the workspace to search templates in
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 45 agents privately built on Nagent that already use Mural.
Build on Nagent
Connect Mural to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Mural, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Mural is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Mural is connected, you configure its 22 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Mural steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Mural event fires, the agent kicks off automatically.
Every Mural action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Mural ships with 22 pre-built team collaboration actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Mural together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Mural-based workflows tailored to your business.