NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Mural connects to a Nagent workspace with OAuth sign-in. Once it is connected, agents can call 22 Mural actions, such as "Create sticky note", "Get current user" and "Get files for a mural". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Mural, with input parameters and output schema.
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
Agents can call 22 Mural actions on Nagent, including "Create sticky note", "Get current user" and "Get files for a mural". Create sticky note: Create one or more sticky note widgets on a mural. Each action is listed on this page with its input parameters and its output.
Mural connects with OAuth sign-in, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create sticky note takes 2 required inputs: muralId and stickies. It returns data, error and successful.