NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Mapulus connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Mapulus actions: "Find Location by External ID", "Get Map Details" and "List Maps". 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 Mapulus, with input parameters and output schema.
MAPULUS_FIND_LOCATION_WITH_EXTERNAL_IDFind locations by their external identifier. Returns a list of locations that match the provided external_id. External IDs are unique identifiers used for integrating Mapulus with external systems (CRM, databases, etc.). Returns an empty list if no matching locations are found.
Input parameters
External identifier used to find matching location(s). This is a unique identifier assigned to locations for external system integration.
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
MAPULUS_GET_MAP_DETAILSTool to retrieve detailed information about a map. Use when you have a map_id and need full map metadata.
Input parameters
The unique identifier of the map 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
MAPULUS_LIST_MAPSRetrieves a paginated list of all maps accessible to the authenticated user. Supports filtering by name/tag and sorting by various fields. Returns map metadata including IDs, titles, and timestamps. Use this to discover available maps before fetching detailed information or locations.
Input parameters
Filter maps by a specific tag (exact match). Returns only maps that have this exact tag.
Filter maps by title using partial text match (case-insensitive). Returns maps whose title contains this text.
Page number to retrieve (starting from 1). Leave empty to get the first page.
Field name to sort results by. Common values: 'title', 'created_at', 'updated_at'. Defaults to 'created_at' if not specified.
Number of maps to return per page (1-100). Leave empty for API default (typically 50).
Sort direction: 'asc' for ascending (A-Z, oldest first) or 'desc' for descending (Z-A, newest first). Defaults to 'desc'.
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 3 Mapulus actions on Nagent: "Find Location by External ID", "Get Map Details" and "List Maps". Find Location by External ID: Find locations by their external identifier. Each action is listed on this page with its input parameters and its output.
Mapulus connects with an API key, 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.
Find Location by External ID takes 1 required input: external_id. It returns data, error and successful.