NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Rollbar connects to a Nagent workspace with an API key. Once it is connected, agents can call 17 Rollbar actions, such as "Get Occurrences Metrics", "Get Project" and "Get Team by ID". 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 Rollbar, with input parameters and output schema.
ROLLBAR_CHECK_TEAM_PROJECT_ASSIGNMENTTool to check if a team is assigned to a project in Rollbar. Use when you need to verify team-project relationships or validate access permissions. Returns 404 if the project is not assigned to the team.
Input parameters
The unique identifier of the team to check
The unique identifier of the project to check
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
ROLLBAR_CHECK_USER_TEAM_ASSIGNMENTTool to check if a user is assigned to a team in Rollbar. Use when you need to verify team membership for a specific user.
Input parameters
The unique identifier of the team to check
The unique identifier of the user to check
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
ROLLBAR_GET_OCCURRENCES_METRICSGet occurrence counts over a span of time with flexible grouping, filtering, and aggregation. Use this to analyze error patterns, track occurrence metrics across time periods, and generate custom reports by grouping on fields like environment, platform, or user attributes.
Input parameters
Sort configuration for query results.
Total rows/groups to return in the result set
Specific offset/starting point for pagination
Array of filter conditions to apply to the query. Filters narrow results by specific field values
Unix timestamp of end time for the query, inclusive
Array of column names on which to group the results
Timezone for the query results. Default is US/Pacific. Examples: Europe/London, Japan
Array of aggregate functions to perform for each group. Supports count_all, count_distinct, max, and min
Unix timestamp of start time for the query
Timepoint size for returned results.
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
ROLLBAR_GET_PROJECTTool to retrieve details of a specific Rollbar project by its ID. Use when you need to get project information including name, status, settings, and timestamps.
Input parameters
The unique identifier of the project 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
ROLLBAR_GET_TEAMTool to retrieve details of a specific team by ID. Use when you need to fetch information about a team including its name, account ID, and access level.
Input parameters
The unique identifier of the team 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
ROLLBAR_GET_TTR_METRICSGet resolution time metrics for a list of projects. Use when you need to analyze how long it takes to resolve issues in Rollbar projects.
Input parameters
List of level names to filter by (e.g., error, warning, info).
Unix timestamp of end time for the query, inclusive. Default is the current timestamp.
Function to aggregate time-to-resolution metrics.
Timezone for the results. Default is US/Pacific. Examples: Europe/London, Japan, UTC.
List of framework names to filter by.
Unix timestamp of start time for the query. Required.
Timepoint size of the returned results.
List of project IDs. Requires Account Access Token.
List of environment names to filter by.
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
ROLLBAR_GET_USERTool to retrieve a specific user from Rollbar by their user ID. Use when you need to fetch user details including username, email, and notification settings.
Input parameters
The unique identifier of the user 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
ROLLBAR_LIST_ALL_PROJECTSTool to list all projects in the Rollbar account. Use when you need to retrieve all projects associated with the account.
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
ROLLBAR_LIST_ALL_TEAMSTool to list all teams in a Rollbar account. Use when you need to retrieve all teams for an account.
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
ROLLBAR_LIST_ALL_USERSTool to list all users in the Rollbar account. Use when you need to retrieve user information or filter users by email address.
Input parameters
Filter the list of users by email address. If provided, only users with matching email will be returned.
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
ROLLBAR_LIST_PROJECT_TEAMSTool to list all teams with access to a Rollbar project. Use when you need to retrieve teams associated with a specific project.
Input parameters
Unique identifier of the Rollbar project to list teams for.
When set to 1 or true, excludes built-in teams (Owners, Everyone) from the response. Set to 0 or omit to include all teams.
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
ROLLBAR_LIST_RQL_JOBSTool to list all RQL (Rollbar Query Language) jobs. Use when you need to retrieve all RQL jobs and their statuses.
Input parameters
Page number starting from 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
ROLLBAR_LIST_TEAM_INVITATIONSTool to list pending invitations to a Rollbar team. Use when you need to view all outstanding team invitations.
Input parameters
Page number for pagination. Returns up to 5000 results per page. Use page=2, page=3, etc. to get subsequent pages.
Unique identifier of the team to list invitations 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
ROLLBAR_LIST_TEAM_PROJECTSTool to list all projects a team has access to in Rollbar. Use when you need to see which projects are associated with a specific team.
Input parameters
The unique identifier of the team whose projects you want to 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
ROLLBAR_LIST_TEAM_USERSTool to list all users in a Rollbar team. Use when you need to retrieve team membership information.
Input parameters
Results are returned in sets of 5000. Access more results by specifying page=2, etc.
The unique identifier for the team.
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
ROLLBAR_LIST_USER_PROJECTSTool to list all projects a user has access to. Use when you need to retrieve projects for a specific user by their user ID.
Input parameters
The unique identifier of the user whose projects 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
ROLLBAR_LIST_USER_TEAMSTool to list all teams a user belongs to in Rollbar. Use when you need to retrieve team memberships for a specific user.
Input parameters
The unique identifier of the user whose teams you want to 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
Agents can call 17 Rollbar actions on Nagent, including "Get Occurrences Metrics", "Get Project" and "Get Team by ID". Get Occurrences Metrics: Get occurrence counts over a span of time with flexible grouping, filtering, and aggregation. Each action is listed on this page with its input parameters and its output.
Rollbar 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.
Get Occurrences Metrics takes 2 required inputs: end_time and start_time. It also takes 8 optional inputs: sort, limit, offset, filters, group_by, timezone, aggregates and granularity. It returns data, error and successful.