NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
21risk connects to a Nagent workspace with an API key. Once it is connected, agents can call 8 21risk actions, such as "Get Compliance", "Get Items (BETA)" and "Get Items Per Month". 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 21risk, with input parameters and output schema.
_21RISK_GET_COMPLIANCETool to retrieve compliance data for sites, categories, or questions. Use when you need OData-based compliance data for analytics or reporting.
Input parameters
Maximum number of records to return (minimum 1).
Number of records to skip for paging (minimum 0).
Whether to include a total count of matching records.
Comma-separated list of related entities to expand.
OData filter expression to narrow results (e.g., 'Rank gt 5').
Comma-separated list of properties to include in the response (e.g., 'Name,Rank').
OData orderby clause to sort results (e.g., 'Rank desc').
Server-driven pagination token from previous response.
Max size in MB for each request, between 1 and 450 (default is 50).
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
_21RISK_GET_ITEMSTool to retrieve items (BETA) from the 21RISK OData API. Use when you need a filtered and paged list of items for analytics and reporting. Example: GET_ITEMS($filter="Item Cost gt 100", $top=50).
Input parameters
Maximum number of items to return (>=1).
Number of items to skip (offset) for pagination.
Navigation properties to expand.
OData $filter expression, e.g., 'Item Cost gt 100'.
Comma-separated list of properties to include in the response, e.g., 'Item Cost,Item Date'.
Comma-separated ordering of properties, e.g., 'Item Date 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
_21RISK_GET_ITEMS_PER_MONTHTool to retrieve fact table data for ItemsPerMonth, one row per question per site per month. Use when querying monthly item data with OData parameters ($filter, $top, $skip, $select, maxPageSizeInMb).
Input parameters
Maximum number of records to return
Number of records to skip for pagination
OData filter expression, e.g. siteId eq '123' and year eq 2023
Comma-separated list of properties to include, e.g. 'siteId,questionId,month,year'
Maximum payload size per request in MB (1–450)
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
_21RISK_GET_ORGANIZATIONSTool to retrieve organizations from the 21RISK OData API. Use when you need to list, filter, or paginate organizations via OData parameters after authentication is confirmed.
Input parameters
Maximum number of organizations to return (>=1).
Number of organizations to skip (offset) for pagination.
OData $filter expression to filter organizations, e.g., 'Status eq 1'.
OData $orderby expression to sort results, e.g., 'Name 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
_21RISK_GET_PROPERTIESTool to fetch a list of properties related to sites, including COPE information and other relevant data. Use when you need property insurance details via OData API after authentication.
Input parameters
Maximum number of records to return (>=1).
Number of records to skip for pagination (>=0).
OData $filter expression to filter properties, e.g., 'Site Status eq 'Active''.
Comma-separated list of fields to include, e.g., 'Site Name,Site Address'.
Comma-separated list of fields to order by, e.g., 'Site Name 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
_21RISK_GET_REPORTSTool to retrieve audit reports, including draft, published, and scheduled reports. Use when you need a paginated list of reports with optional OData filtering.
Input parameters
Number of items to include in the result (>=1).
OData filter to narrow results (e.g., `Report Status eq 'published'`).
Opaque token for server-driven pagination from previous responses.
Maximum payload size in MB for each request (1-450). Defaults to 50 if not provided.
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
_21RISK_GET_RISKMODEL_CATEGORIESTool to retrieve risk model categories for grouping questions and compliance checks. Use when you need to filter, select, or paginate risk model categories via OData parameters ($filter, $select, $orderby, $top, $skip, $count).
Input parameters
Maximum number of records to return (minimum 1)
Number of records to skip for pagination (minimum 0)
Whether to include a total count of matching records in the response
Comma-separated list of related entities to expand
OData filter expression to narrow results, e.g., _KeyModelId eq 'model123'
Comma-separated list of properties to include in the response, e.g., 'Category Name,Category Level'
OData orderby clause to sort results, e.g., 'Category Level Sort Order desc'
Server-driven pagination token from previous response
Maximum payload size per request in MB (1–450)
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
_21RISK_GET_RISK_MODELSTool to retrieve risk models used for audits and compliance. Use when you need to list available risk models with optional OData queries.
Input parameters
Maximum number of risk models to return (>=1).
Number of risk models to skip (offset) for pagination, default is 0.
Include total count of matching records when set to true.
OData $expand expression to include related entities inline.
OData $filter expression to filter risk models, e.g., `Name eq 'Operational Risk'`.
OData $select expression to limit fields returned, e.g., `Name,Description`.
OData $orderby expression to sort results, e.g., `CreatedDate desc`.
Opaque token for server-driven pagination from previous responses.
Maximum payload size in MB for each request (1-450). Defaults to service default if not set.
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 8 21risk actions on Nagent, including "Get Compliance", "Get Items (BETA)" and "Get Items Per Month". Get Compliance: Retrieve compliance data for sites, categories, or questions. Each action is listed on this page with its input parameters and its output.
21risk 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 also takes 9 optional inputs: top, skip, count, expand, filter, select, orderby, skiptoken and _maxPageSizeInMb. It returns data, error and successful.