NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Mopinion connects to a Nagent workspace with an API key. Once it is connected, agents can call 11 Mopinion actions, such as "Get Account", "Get Dataset by ID" and "Get Dataset Feedback". 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 Mopinion, with input parameters and output schema.
MOPINION_GET_ACCOUNTTool to retrieve the current authenticated account information. Use to verify authentication and get account details.
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
MOPINION_GET_DATASET_BY_IDRetrieve complete metadata for a specific Mopinion dataset (feedback form) by its ID. Returns dataset properties including name, associated report ID, data source type, and description. Use this action when you need detailed information about a specific dataset/form. To discover available dataset IDs, use the List Datasets action first. This is a read-only operation that does not modify any data.
Input parameters
The unique identifier of the dataset (form) to retrieve. Can be provided as an integer or string. Use the List Datasets action to discover available dataset IDs.
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
MOPINION_GET_DATASET_FEEDBACKRetrieve feedback items (survey responses) for a specific dataset/form with optional pagination and filtering. Use this action to fetch multiple feedback entries from a dataset. Each feedback item contains the survey responses including custom fields, scores, metadata, and timestamps. Supports pagination for large result sets and filtering by field values. For retrieving a single feedback item by ID, use GET_DATASET_FEEDBACK_BY_ID instead.
Input parameters
Page number to return
Maximum number of results per page (max 100)
Field-level filters as a map of field_key to filter value. Serialized as filter\[{field_key}\]=value in the query string
Identifier of the dataset (form) to retrieve feedback for
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
MOPINION_GET_DATASET_FEEDBACK_BY_IDRetrieves a single feedback item by its unique identifier from a specific dataset. Use this tool when you need detailed information about a specific feedback item. First obtain the dataset_id using List Datasets, then get feedback_id values using Get Dataset Feedback. **Important Notes:** - Returns a warning in metadata if the feedback item doesn't exist (with null field values) - Returns 404 error if the dataset_id itself is invalid or inaccessible - The response includes feedback fields, tags, scores, timestamps, and associated metadata
Input parameters
Numeric identifier of the dataset (form) containing the feedback. Obtain this from List Datasets action.
Numeric identifier of the specific feedback item to retrieve. Obtain this from Get Dataset Feedback action.
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
MOPINION_GET_DATASET_FIELDSTool to retrieve field definitions for a dataset. Use when you need the schema of a dataset's fields.
Input parameters
Unique identifier of the dataset whose field definitions should be retrieved. Use the LIST_DATASETS action to discover available dataset IDs.
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
MOPINION_GET_DEPLOYMENT_BY_IDRetrieves detailed configuration for a specific feedback form deployment by its ID. Returns deployment rules, trigger conditions, scheduling settings, target URLs, and active status. Use this to understand when, where, and how a feedback form is displayed to users.
Input parameters
The deployment key (identifier) to retrieve. This is the 'key' field from the deployments list.
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
MOPINION_GET_DEPLOYMENTSTool to list all deployments for the authenticated Mopinion account. Use after setting up authentication.
Input parameters
Optional Accept header override, e.g., application/json
Optional Mopinion API version header value, e.g., v1 or v2
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
MOPINION_GET_REPORT_BY_IDRetrieves detailed information about a specific Mopinion report by its ID. Returns comprehensive report details including name, description, language, creation date, and all associated datasets with their metadata. Use this when you need full information about a specific report. To find available report IDs, use the Get Reports action first. Example use case: Get complete details of report 22511 to understand its datasets and configuration.
Input parameters
Unique numeric identifier of the Mopinion report to retrieve. Obtain this from the Get Reports action.
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
MOPINION_GET_REPORT_FEEDBACKTool to retrieve feedback items for a report. Use when you need paginated and filtered feedback entries for analysis.
Input parameters
Page number to retrieve (1-based).
Maximum number of feedback items to return per page (1-100).
Server-side filters serialized as filter\[field\]=value in query parameters.
The unique identifier of the report to retrieve feedback for.
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
MOPINION_GET_REPORT_FIELDSTool to retrieve field definitions for a specific report. Use when you need the schema of a report's feedback fields before constructing or analyzing forms.
Input parameters
The unique ID of the report to retrieve fields for.
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
MOPINION_GET_ROOTCheck Mopinion API availability and get version information. Pings the API health check endpoint (/ping) and returns status code, 'pong' response, and current API version. Use this to verify the API is reachable and operational.
Input parameters
Optional path to append to the base URL. Defaults to '/ping' for the standard health check endpoint. Use this to test other endpoints if needed.
Optional override for the Mopinion API base URL. If not provided, the action uses the connection's base_url when it points to a Mopinion domain; otherwise it falls back to 'https://api.mopinion.com'.
Whether to include the Authorization header in the request. Defaults to False because the root ping does not require 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
Agents can call 11 Mopinion actions on Nagent, including "Get Account", "Get Dataset by ID" and "Get Dataset Feedback". Get Account: Retrieve the current authenticated account information. Each action is listed on this page with its input parameters and its output.
Mopinion 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.
It returns data, error and successful.