# Bugsnag

Bugsnag is an error monitoring and stability management platform that helps developers identify, prioritize, and fix software bugs.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 60
- **Triggers:** 0
- **Slug:** `BUGSNAG`
- **Version:** 20260309_00

## Tools

### Add Collaborator to Teams

**Slug:** `BUGSNAG_ADD_ORGANIZATION_COLLABORATOR_TEAM_MEMBERSHIPS`

Tool to add a collaborator to a group of teams in a Bugsnag organization. Use when you need to assign a collaborator to specific teams or all teams. Requires admin permissions on the organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team_ids` | array | No | IDs of the teams to assign the collaborator to. Required if add_all_teams is false or not provided. |
| `add_all_teams` | boolean | No | Whether to assign the collaborator to all teams in the organization. If false, team_ids must be provided. |
| `collaborator_id` | string | Yes | The ID of the collaborator |
| `organization_id` | string | Yes | The ID of the organization |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Collaborators to Team

**Slug:** `BUGSNAG_ADD_ORGANIZATION_TEAM_MEMBERSHIPS`

Tool to add collaborators to a team in a Bugsnag organization. Use when you need to add specific collaborators or all organization collaborators to a team. Requires admin permissions on the organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the team to add collaborators to |
| `organization_id` | string | Yes | ID of the organization |
| `collaborator_ids` | array | No | Collaborators to add to the team. Should not be set if add_all_collaborators is true. |
| `add_all_collaborators` | boolean | No | Add all organization collaborators to the team. This should not be set if collaborator_ids is specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Update Errors

**Slug:** `BUGSNAG_BULK_UPDATE_ERRORS`

Bulk update multiple errors in a Bugsnag project. Applies the same operation to all specified errors. Note: The actual API implementation returns only the operation name in the response, not per-error results. This differs from the OpenAPI specification which documents detailed per-error results. A successful response indicates the bulk operation was accepted and applied to all specified errors. Use cases: - Mark multiple errors as fixed after a release - Assign errors to a team member for investigation - Snooze or ignore low-priority errors in bulk - Link multiple related errors to a single issue tracker ticket - Change severity levels across related errors Prerequisites: Obtain project_id from BUGSNAG_LIST_PROJECTS and error_ids from BUGSNAG_LIST_ERRORS_ON_PROJECT.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `severity` | string | No | New severity level. Required when operation is 'overridden_severity'. Valid values: 'error', 'warning', 'info'. |
| `error_ids` | array | Yes | List of error IDs to update All IDs must belong to the specified project_id; cross-project IDs cause failures. |
| `issue_url` | string | No | HTTP link to an external issue. Required when operation is 'link_issue' or 'create_issue'. |
| `operation` | string ("overridden_severity" | "assign" | "create_issue" | "link_issue" | "unlink_issue" | "open" | "snooze" | "fix" | "ignore" | "delete" | "discard") | Yes | Operation to perform on the errors. Exact values only: 'fix', 'open', 'snooze', 'ignore', 'assign', 'link_issue', 'create_issue', 'overridden_severity'. Variants like 'fixed' or 'close' are invalid. |
| `project_id` | string | Yes | Identifier of the project containing the errors |
| `issue_title` | string | No | Title to set on a created or linked issue. Used with 'link_issue' or 'create_issue' operations. |
| `reopen_rules` | object | No | Rules for automatically reopening the error. Required when operation is 'snooze'. |
| `notification_id` | string | No | ID of the issue tracker to use for issue operations. Used with 'link_issue' or 'create_issue' operations. |
| `assigned_team_id` | string | No | ID of team to assign the errors to. Required when operation is 'assign' and assigning to a team. Mutually exclusive with assigned_collaborator_id. |
| `verify_issue_url` | boolean | No | Whether to verify the issue_url with the configured issue tracker. Used with 'link_issue' or 'create_issue' operations. |
| `assigned_collaborator_id` | string | No | ID of collaborator to assign the errors to. Required when operation is 'assign' and assigning to a user. Mutually exclusive with assigned_team_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Configure Integration

**Slug:** `BUGSNAG_CONFIGURE_INTEGRATION`

Tool to configure a new integration for a Bugsnag project. Use after selecting integration key and preparing credentials.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label` | string | No | Optional human-readable label for this configured integration |
| `project_id` | string | Yes | ID of the Bugsnag project to configure the integration for. Get this from BUGSNAG_LIST_PROJECTS. |
| `configuration` | object | Yes | Integration-specific configuration object containing credentials and connection parameters. Required fields depend on the integration - check BUGSNAG_LIST_SUPPORTED_INTEGRATIONS for details. |
| `integration_key` | string | Yes | Key identifying the integration service (e.g., 'asana', 'slack', 'jira', 'github-issues'). Use BUGSNAG_LIST_SUPPORTED_INTEGRATIONS to get available keys and required configuration fields. |
| `issue_automation` | object | No | Optional settings for automatic issue-tracker triggers |
| `disable_severities` | array | No | Optional list of severity levels to disable for this integration |
| `disable_release_stages` | array | No | Optional list of release stages for which this integration should be disabled |
| `disable_unhandled_states` | array | No | Optional list of unhandled states to disable for this integration |
| `integration_connection_id` | string | No | Optional ID of an existing integration connection to base this configuration on |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Confirm Project Event Data Deletion

**Slug:** `BUGSNAG_CONFIRM_PROJECT_EVENT_DATA_DELETION`

Confirms a project event data deletion request in Bugsnag. Use this action after creating a deletion request to confirm and proceed with the actual deletion of event data. The deletion request must be in AWAITING_CONFIRMATION status before it can be confirmed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the deletion request to confirm |
| `project_id` | string | Yes | ID of the project of the deletion request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Invite Collaborator

**Slug:** `BUGSNAG_CREATE_COLLABORATOR`

Invites a new collaborator to a Bugsnag organization by email. Use this action to grant a user access to the organization. Optionally specify project_ids to restrict access to specific projects, or set admin=true to grant full admin privileges across all projects. Returns the collaborator details including their invitation status (pending_invitation=true until they accept). Re-inviting an existing email returns the existing collaborator data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `admin` | boolean | No | Whether the collaborator should have admin privileges |
| `email` | string | Yes | Email address of the collaborator to invite |
| `project_ids` | array | No | Optional list of project IDs the collaborator should have access to. If omitted, no project-specific permissions are set. |
| `organization_id` | string | Yes | ID of the Bugsnag organization to which the user will be invited |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Custom Event Field

**Slug:** `BUGSNAG_CREATE_CUSTOM_EVENT_FIELD`

Creates a custom event field for a Bugsnag project, enabling filtering and pivoting on custom metadata. Use this tool when you need to create a new searchable/filterable field from event metaData. Requires a project_id (get from BUGSNAG_LIST_PROJECTS), a unique display_id for the filter, and the path to the data in event metaData. Example: Create a custom field to filter by user account ID: - display_id: "custom.user.accountId" - path: "metaData.user.accountId" - filter_options: {"name": "Account ID", "match_types": ["eq", "ne"]}

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | JSON path to the data field in event metaData (e.g., 'metaData.user.accountId'). Use dot notation for nested fields. |
| `reindex` | boolean | No | If True, reindex historical events to populate this field with past data (may take time) |
| `display_id` | string | Yes | Unique identifier for the custom event field used in filters (e.g., 'custom.user.accountId'). Must be unique within the project. |
| `project_id` | string | Yes | ID of the project to create the custom event field for |
| `pivot_options` | object | No | Pivot options for the request when creating a custom event field. |
| `filter_options` | object | Yes | Configuration for how the field appears and behaves in filters |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Organization Project

**Slug:** `BUGSNAG_CREATE_ORGANIZATION_PROJECT`

Tool to create a new project in a Bugsnag organization. Use when you need to set up a new project for error tracking under a specific organization. Requires organization_id, project name, and platform type. Optionally configure browser filtering for JavaScript projects.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The new project's name. Note that the first character should not start with a '$'. |
| `type` | string ("android" | "angular" | "asgi" | "aspnet" | "aspnet_core" | "backbone" | "bottle" | "cocos2dx" | "connect" | "django" | "dotnet" | "dotnet_desktop" | "dotnet_mvc" | "electron" | "ember" | "eventmachine" | "expo" | "express" | "flask" | "flutter" | "gin" | "go" | "go_net_http" | "heroku" | "ios" | "java" | "java_desktop" | "js" | "vega" | "koa" | "laravel" | "lumen" | "magento" | "martini" | "minidump" | "ndk" | "negroni" | "nintendo_switch" | "node" | "osx" | "other_desktop" | "other_mobile" | "other_tv" | "php" | "python" | "rack" | "rails" | "react" | "reactnative" | "restify" | "revel" | "ruby" | "silex" | "sinatra" | "spring" | "symfony" | "tornado" | "tvos" | "unity" | "unrealengine" | "vue" | "watchos" | "webapi" | "wordpress" | "wpf" | "wsgi" | "other") | Yes | Project platform type. Used to indicate the framework or platform the project uses (e.g., 'node' for Node.js, 'react' for React, 'ios' for iOS apps). |
| `organization_id` | string | Yes | ID of the Bugsnag organization where the project will be created. Obtain this from the List Organizations action. |
| `ignore_old_browsers` | boolean | No | For JavaScript projects, this will filter errors from older browsers. Set to true to ignore errors from old browser versions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Organization Team

**Slug:** `BUGSNAG_CREATE_ORGANIZATION_TEAM`

Tool to create a new team in a Bugsnag organization. Use when you need to organize collaborators into teams for better access management. The team name must be unique within the organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the team to create. Must be unique within the organization and not too long. |
| `organization_id` | string | Yes | ID of the organization where the team will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Organization Data Deletion Request

**Slug:** `BUGSNAG_CREATE_ORG_DATA_DELETION`

Tool to create an event data deletion request for GDPR/CCPA compliance. Use when you need to delete event data matching specific criteria (e.g., user email, error class, device info). Specify filters to target events - most common is filtering by user.email. The deletion processes asynchronously; check the returned status and id to track progress. Requires organization administrator permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Map of event field names to arrays of filter conditions. Common fields: 'user.email', 'user.id', 'user.name', 'event.class', 'app.release_stage', 'device.hostname', 'error.id'. See Bugsnag API docs for complete list. Example: {'user.email': [{'type': 'eq', 'value': 'test@example.com'}]} |
| `filter_groups` | object | No | Advanced: Map of filter groups for complex queries. Each group has a 'join' operator and filters. Use either 'filters' (simple) OR 'filter_groups' (advanced), not both. See https://developer.smartbear.com/bugsnag/docs/data-access-filtering |
| `organization_id` | string | Yes | ID of the organization to delete events from. Can be obtained from BUGSNAG_LIST_ORGANIZATIONS action. |
| `skip_confirmation` | boolean | No | If true, skip requiring another request to confirm the deletion. Default is false. |
| `filter_groups_join` | string ("and" | "or") | No | Join operator to apply between filter groups. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Organization Data Request

**Slug:** `BUGSNAG_CREATE_ORG_DATA_REQUEST`

Tool to create an event data request for a Bugsnag organization (GDPR/CCPA compliance). Use when you need to export event data for a specific user or set of conditions to comply with data access requests. The request is processed asynchronously - check the status field and use the returned ID to monitor progress. Once completed, the url field provides a download link for the data export.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Simple filters map with event field names as keys and lists of filter conditions as values. Common fields: 'user.email', 'user.id', 'user.name', 'event.class', 'event.severity', 'error.status', etc. Use empty dict {} to request all events. For more complex filtering, use filter_groups instead. |
| `report_type` | string ("gdpr") | No | Type of data request report |
| `filter_groups` | object | No | Advanced filters using filter groups. Each group is keyed with a unique identifier (e.g., '0', '1'). See API documentation for advanced filtering details. Use either 'filters' or 'filter_groups', not both. |
| `organization_id` | string | Yes | ID of the organization to request event data for |
| `filter_groups_join` | string ("and" | "or") | No | Join operator for filter groups |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Project Event Data Deletion Request

**Slug:** `BUGSNAG_CREATE_PROJECT_DATA_DELETION`

Tool to create an event data deletion request for a specific project. Use when you need to delete event data matching specific criteria (e.g., error class, severity, user email) within a project. Specify filters to target events - most common is filtering by event.class or user.email. The deletion processes asynchronously; check the returned status and id to track progress.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Map of event field names to arrays of filter conditions. Common fields: 'event.class', 'event.message', 'event.severity', 'app.release_stage', 'user.email', 'user.id', 'device.hostname', 'error.id', 'error.status'. See Bugsnag API docs for complete list. Example: {'event.class': [{'type': 'eq', 'value': 'RuntimeError'}]} |
| `project_id` | string | Yes | ID of the project to delete events from. Can be obtained from BUGSNAG_LIST_PROJECTS action. |
| `filter_groups` | object | No | Advanced: Map of filter groups for complex queries. Each group has a 'join' operator ('and' or 'or') and 'filters' object. Use either 'filters' (simple) OR 'filter_groups' (advanced), not both. See https://developer.smartbear.com/bugsnag/docs/data-access-filtering for details. |
| `skip_confirmation` | boolean | No | If true, skip requiring another request to confirm the deletion. Default is false. |
| `filter_groups_join` | string ("and" | "or") | No | Join operator to apply between filter groups. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Project Event Data Request

**Slug:** `BUGSNAG_CREATE_PROJECT_EVENT_DATA_REQUEST`

Tool to create an event data request for a Bugsnag project. Use when you need to export event data matching specific filters. The request is processed asynchronously - check the returned status and use the provided ID to poll for completion. Once completed, the 'url' field provides a download link for the event data. Supports GDPR/data subject access requests via the 'gdpr' report_type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Filter conditions to determine which events to include in the data request. Use an empty dict {} to request all events. Supports filters on error fields (error.status, error.id), event fields (event.class, event.message, event.severity, event.since, event.before), app fields (app.release_stage, app.context), user fields (user.email, user.id), device fields, browser fields, OS fields, and more. See Bugsnag filtering docs for complete list. |
| `project_id` | string | Yes | ID of the Bugsnag project to request event data for. Obtain this from the list_projects action. |
| `report_type` | string ("gdpr") | No | Type of report to generate. |
| `filter_groups` | object | No | Advanced filter groups for complex filtering logic. Each group is keyed with a unique identifier (e.g., '0', '1') and contains a 'join' operator and filter conditions. See Bugsnag Advanced Filters documentation for details. |
| `filter_groups_join` | string ("and" | "or") | No | Join operator between filter groups. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Saved Search

**Slug:** `BUGSNAG_CREATE_SAVED_SEARCH`

Creates a saved search (filterset) for a Bugsnag project that persists filter and sort configurations. Use this to save frequently used error filters for quick access in the dashboard. Requires a valid project_id which can be obtained from the list_projects action. The saved search can be made the project default and/or shared with collaborators.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | A descriptive name for the saved search that will be displayed in the dashboard |
| `sort` | string | No | Sort order for errors in the saved search. Options include: 'events' (most events), 'users' (most affected users), 'last_seen', 'first_seen'. Defaults to 'unspecified'. |
| `shared` | boolean | No | If true, this saved search will be visible to all collaborators on the project |
| `filters` | object | No | Filter conditions mapping field names (e.g., 'error.status') to a list of filter items. Common filter fields include: 'error.status' (open, fixed, ignored, snoozed, for_review, new), 'error.severity' (error, warning, info). Empty dict {} returns all errors. |
| `project_id` | string | Yes | The unique identifier of the Bugsnag project to create the saved search for. Obtain this from list_projects action. |
| `project_default` | boolean | No | If true, this saved search becomes the default view for the current user when viewing this project |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete All Errors in a Project

**Slug:** `BUGSNAG_DELETE_ALL_ERRORS_IN_PROJECT`

Permanently deletes all errors and event data from a Bugsnag project. WARNING: This action is IRREVERSIBLE. All error and event data will be permanently removed. Requirements: - User must have Project Owner or Organization Administrator permissions - A valid project_id is required (use BUGSNAG_LIST_PROJECTS to retrieve project IDs) Use this tool when you need to clear all error history from a project, such as during cleanup operations or before a major release.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | The unique identifier of the Bugsnag project. Can be obtained from the BUGSNAG_LIST_PROJECTS action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Collaborator

**Slug:** `BUGSNAG_DELETE_COLLABORATOR`

Removes a collaborator from a Bugsnag organization. This action permanently revokes the user's access to all projects within the organization. Before using, obtain the organization_id from List Organizations and the collaborator_id from List Collaborators. Requires Organization Administrator privileges. Cannot remove the last admin of an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collaborator_id` | string | Yes | The unique identifier of the collaborator to remove. Obtain this from the List Collaborators action. |
| `organization_id` | string | Yes | The unique identifier of the Bugsnag organization. Obtain this from the List Organizations action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete a configured integration

**Slug:** `BUGSNAG_DELETE_CONFIGURED_INTEGRATION`

Tool to delete a configured integration. Use when you need to remove an existing integration from a project after confirming the integration ID. This action cannot be undone and requires Organization Administrator or Project Owner permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the configured integration to delete. Obtain this ID by calling the 'List Configured Integrations for Project' action first. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Custom Event Field

**Slug:** `BUGSNAG_DELETE_EVENT_FIELD`

Deletes a custom event field from a Bugsnag project. Use this tool when you need to remove a custom event field that was previously created via BUGSNAG_CREATE_CUSTOM_EVENT_FIELD. This action only works for custom event fields (where 'custom' is true) - built-in event fields cannot be deleted. Prerequisites: - Get the project_id from BUGSNAG_LIST_PROJECTS - Get the display_id from BUGSNAG_LIST_EVENT_FIELDS_FOR_PROJECT (filter for custom: true) Note: Requires a Bugsnag Preferred or Enterprise plan to use custom event fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `display_id` | string | Yes | The display identifier of the custom event field to delete. This is the identifier used for filtering (e.g., 'custom.user.accountId'). Get this from BUGSNAG_LIST_EVENT_FIELDS_FOR_PROJECT by filtering for fields where 'custom' is true. Note: Built-in event fields cannot be deleted. |
| `project_id` | string | Yes | The unique ID of the Bugsnag project containing the custom event field. Get this from BUGSNAG_LIST_PROJECTS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Organization

**Slug:** `BUGSNAG_DELETE_ORGANIZATION`

Permanently deletes a Bugsnag organization. This action is irreversible and removes all organization data including projects, collaborators, and settings. Use BUGSNAG_LIST_ORGANIZATIONS to find the organization_id. Requires Organization Administrator permissions. Note: Heroku organizations cannot be deleted via the API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | The unique identifier of the organization to delete. Can be obtained from BUGSNAG_LIST_ORGANIZATIONS action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Organization Team

**Slug:** `BUGSNAG_DELETE_ORGANIZATION_TEAM`

Tool to delete a team from a Bugsnag organization. Use when you need to permanently remove a team. Requires organization admin permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the team to be deleted. |
| `organization_id` | string | Yes | The unique identifier of the Bugsnag organization. Obtain this from the List Organizations action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Project

**Slug:** `BUGSNAG_DELETE_PROJECT`

Permanently deletes a Bugsnag project. This action is irreversible and removes all project data including errors, events, and settings. Use BUGSNAG_LIST_PROJECTS to find the project_id. Requires admin or project owner permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | The unique identifier of the project to delete. Can be obtained from BUGSNAG_LIST_PROJECTS action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Saved Search

**Slug:** `BUGSNAG_DELETE_SAVED_SEARCH`

Permanently deletes a saved search (filterset) from a Bugsnag project. Use this to remove saved searches that are no longer needed. Requires the saved_search_id which can be obtained from list_saved_searches_on_project or from the response when creating a saved search. This action cannot be undone - the saved search will be permanently removed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `saved_search_id` | string | Yes | The unique identifier of the saved search to delete. Obtain this ID from the 'List Saved Searches on Project' action or from a previously created saved search response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Configured Integration

**Slug:** `BUGSNAG_GET_CONFIGURED_INTEGRATION`

Tool to retrieve details of a specific configured integration by its ID. Returns configuration details, status, automation settings, and usage information. Use 'List Configured Integrations for Project' to obtain valid integration IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the configured integration to retrieve. Obtain this ID from 'List Configured Integrations for Project' or from a previously configured integration. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization By ID

**Slug:** `BUGSNAG_GET_ORGANIZATION_BY_ID`

Tool to view an organization by its ID. Use when you need to retrieve detailed information about a specific Bugsnag organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the organization to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Collaborator Project Access Counts

**Slug:** `BUGSNAG_GET_ORGANIZATION_COLLABORATOR_PROJECT_ACCESS_COUNTS`

Tool to view the project count of collaborators in an organization. Use when you need to retrieve project access counts for specific collaborators.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | ID of the organization to retrieve collaborator project access counts from |
| `collaborator_ids` | array | Yes | IDs of collaborators to view the project count of |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Collaborator Projects

**Slug:** `BUGSNAG_GET_ORGANIZATION_COLLABORATOR_PROJECTS`

Tool to view projects a collaborator has access to in an organization. Use when you need to list all projects that a specific user can access within an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Search projects with names matching this parameter |
| `sort` | string ("created_at") | No | Enum for sort field options. |
| `per_page` | integer | No | How many results to return per page. Defaults to 30 if not specified. |
| `direction` | string ("asc" | "desc") | No | Enum for sort direction options. |
| `collaborator_id` | string | Yes | The ID of the user/collaborator |
| `organization_id` | string | Yes | The ID of the organization |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Event Data Request

**Slug:** `BUGSNAG_GET_ORGANIZATION_EVENT_DATA_REQUEST`

Tool to check the status of an organization event data request. Use when you need to monitor the progress of a data export or GDPR request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the event data request |
| `organization_id` | string | Yes | ID of the organization of the event data request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Team

**Slug:** `BUGSNAG_GET_ORGANIZATION_TEAM`

Tool to show the details of a team in an organization. Use when you need to retrieve information about a specific team including its name, collaborator count, and project count.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the team to retrieve |
| `organization_id` | string | Yes | ID of the Bugsnag organization |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Data Deletion Status

**Slug:** `BUGSNAG_GET_ORG_DATA_DELETION`

Tool to check the status of an organization event data deletion request in Bugsnag. Use this to monitor deletion requests including their current status (PREPARING, AWAITING_CONFIRMATION, ACCEPTED, IN_PROGRESS, COMPLETED, EXPIRED), applied filters, and progress details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the deletion request |
| `organization_id` | string | Yes | ID of the organization of the deletion request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Pivot Values on a Project

**Slug:** `BUGSNAG_GET_PIVOT_VALUES_ON_A_PROJECT`

List pivot values for a project, showing how events are distributed across different values of a field. Use this to analyze event distribution by release stage, app version, user, device type, or other fields at the project level.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base` | string | No | ISO 8601 timestamp to filter events. Only events before this time are included. |
| `sort` | string ("unsorted") | No | Sort option for pivot values |
| `filters` | object | No | Filters to apply to events before calculating pivot values. Dictionary mapping field names to filter specifications. |
| `per_page` | integer | No | Number of pivot values to return per page. Defaults to 30. |
| `project_id` | string | Yes | The unique identifier of the Bugsnag project. Obtain via BUGSNAG_LIST_PROJECTS action. |
| `filter_groups` | object | No | A map of filter groups, where each group is keyed with a unique identifier (e.g., '0', '1'). See Bugsnag Advanced Filters documentation for details. |
| `filter_groups_join` | string ("and" | "or") | No | Join operator for filter groups |
| `event_field_display_id` | string | Yes | The display ID of the event field to pivot on (e.g., 'app.release_stage', 'user.id'). Obtain available fields via BUGSNAG_LIST_PIVOTS_ON_PROJECT action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Project Data Deletion Status

**Slug:** `BUGSNAG_GET_PROJECT_DATA_DELETION`

Tool to check the status of a project event data deletion request in Bugsnag. Use this to monitor deletion requests including their current status (PREPARING, AWAITING_CONFIRMATION, ACCEPTED, IN_PROGRESS, COMPLETED, EXPIRED), applied filters, and progress details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the deletion request |
| `project_id` | string | Yes | ID of the project of the deletion request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Project Event Data Request

**Slug:** `BUGSNAG_GET_PROJECT_EVENT_DATA_REQUEST`

Tool to check the status of a project event data request. Use when you need to monitor the progress of a data export or GDPR request for a specific project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the event data request |
| `project_id` | string | Yes | ID of the project of the event data request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Project Network Grouping Ruleset

**Slug:** `BUGSNAG_GET_PROJECT_NETWORK_GROUPING_RULESET`

Tool to retrieve a project's network grouping ruleset. Use when you need to view the URL patterns used to group network spans for performance monitoring in a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | The ID of the Project to retrieve the endpoints for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Saved Search

**Slug:** `BUGSNAG_GET_SAVED_SEARCH`

Retrieves the details of a specific saved search by its unique ID. Returns comprehensive information about the saved search including its name, filters, sharing status, inclusion criteria for different error states, and timestamps. Requires a valid saved search ID (obtained from 'List Saved Searches on Project' or 'Create Saved Search').

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the saved search to retrieve. Obtain this ID from the 'List Saved Searches on Project' action or from a previously created saved search. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Saved Search Usage Summary

**Slug:** `BUGSNAG_GET_SAVED_SEARCH_USAGE_SUMMARY`

Retrieves usage statistics for a saved search, showing how it is being used across the project. Returns counts of project notifications, collaborator email notifications, and performance monitors that reference this saved search. Use this to understand the impact of modifying or deleting a saved search. Requires a valid saved search ID (obtained from 'List Saved Searches on Project' or 'Create Saved Search').

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the saved search. Obtain this ID from the 'List Saved Searches on Project' action or from a previously created saved search. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Collaborator Access Details for Projects

**Slug:** `BUGSNAG_LIST_COLLABORATOR_ACCESS_DETAILS_FOR_PROJECTS`

Tool to list summary details of the projects a collaborator has access to. Use when reviewing a collaborator's access across an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Query term to filter project names by. |
| `per_page` | integer | No | Number of results per page, 1-30. |
| `inaccessible` | boolean | No | If true, return only inaccessible projects. Defaults to false. |
| `collaborator_id` | string | Yes | ID of the collaborator. |
| `individual_only` | boolean | No | If true, return only individual project access (exclude team-based access). |
| `organization_id` | string | Yes | ID of the organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Collaborators

**Slug:** `BUGSNAG_LIST_COLLABORATORS`

Tool to list collaborators in an organization. Use when you need to retrieve all collaborators for a specified organization. Example: "List collaborators for organization 515fb9337c1074f6fd000001".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | ID of the Bugsnag organization to list collaborators for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Collaborators on Project

**Slug:** `BUGSNAG_LIST_COLLABORATORS_ON_PROJECT`

Tool to list collaborators on a project. Use when you need to retrieve all users with access to a given project after confirming its ID. Example: "List collaborators for project 515fb9337c1074f6fd000001".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per_page` | integer | No | Number of results per page (max 100). Defaults to 30 if not set. |
| `project_id` | string | Yes | ID of the project to list collaborators for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Configured Integrations for Project

**Slug:** `BUGSNAG_LIST_CONFIGURED_INTEGRATIONS_FOR_PROJECT`

Retrieves all configured integrations for a Bugsnag project. Returns details about each integration including its type (e.g., Slack, Jira, Asana), configuration, status, and trigger settings. Use BUGSNAG_LIST_PROJECTS first to obtain a valid project_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | The unique identifier for the Bugsnag project. Obtain this from BUGSNAG_LIST_PROJECTS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Errors on Project

**Slug:** `BUGSNAG_LIST_ERRORS_ON_PROJECT`

List all errors in a Bugsnag project with optional filtering and sorting. Use this to retrieve error summaries including error class, message, severity, status, occurrence counts, and affected users. Results are paginated; follow pagination indicators to retrieve all pages. No status filter parameter exists — filter by open/fixed/ignored status client-side using the status field in responses. Requires a valid project_id which can be obtained from the List Projects action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base` | string | No | ISO 8601 formatted date-time to filter errors from. Only errors seen after this time are returned. |
| `sort` | string ("last_seen" | "first_seen" | "users" | "events" | "unsorted") | No | Field to sort errors by. Options: 'last_seen' (most recent activity), 'first_seen' (when error first occurred), 'users' (number of affected users), 'events' (number of occurrences), 'unsorted'. Defaults to 'last_seen' if not specified. |
| `per_page` | integer | No | Number of errors to return per page. Range: 1-100. Defaults to 30 if not specified. |
| `direction` | string ("asc" | "desc") | No | Sort direction: 'asc' (ascending/oldest first) or 'desc' (descending/newest first). Defaults to 'desc' if not specified. |
| `project_id` | string | Yes | The unique identifier of the Bugsnag project. Obtain this from the List Projects action. |
| `version_seen_in` | array | No | Filter errors by app version. Each filter applies to 'version.seen_in' property to show only errors that occurred in specific app versions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Event Fields for Project

**Slug:** `BUGSNAG_LIST_EVENT_FIELDS_FOR_PROJECT`

Lists all event fields available for filtering and pivoting in a Bugsnag project. Use this action to discover which fields can be used to filter events in the project's error inbox. Common fields include app.release_stage, error.class, user.id, device.os_name, etc. Example: "List event fields for project 515fb9337c1074f6fd000001"

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | The unique identifier of the Bugsnag project. Obtain this from the BUGSNAG_LIST_PROJECTS action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Events for Error

**Slug:** `BUGSNAG_LIST_EVENTS_FOR_ERROR`

Lists individual error event occurrences for a specific error group. Use this after identifying an error_id via BUGSNAG_LIST_ERRORS_ON_PROJECT to retrieve detailed stack traces, metadata, and context for each occurrence. Returns events sorted by timestamp (newest first by default). Supports pagination via 'base' parameter and filtering by event fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base` | string | No | ISO 8601 timestamp. Only events received before this time will be returned. Useful for pagination. |
| `sort` | string | No | Field to sort results by. Currently only 'timestamp' is supported. Defaults to 'timestamp'. |
| `filters` | object | No | Filters to restrict returned events. Dictionary mapping field names to arrays of filter objects. Each filter object has 'type' (eq/ne/empty) and 'value'. Filter types: 'eq' matches values (OR logic), 'ne' excludes values (AND logic), 'empty' checks presence (value: true/false). Example: {"app.release_stage": [{"type": "eq", "value": "production"}]} |
| `error_id` | string | Yes | The error group ID. Obtain via BUGSNAG_LIST_ERRORS_ON_PROJECT action. |
| `per_page` | integer | No | Number of events per page (1-30). Defaults to 30. |
| `direction` | string ("asc" | "desc") | No | Sort direction: 'asc' for oldest first, 'desc' for newest first. Defaults to 'desc'. |
| `project_id` | string | Yes | The Bugsnag project ID. Obtain via BUGSNAG_LIST_PROJECTS action. |
| `full_reports` | boolean | No | If true, includes full event payloads with all details. Defaults to false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Events on Project

**Slug:** `BUGSNAG_LIST_EVENTS_ON_PROJECT`

List all error events for a Bugsnag project. Events are individual occurrences of errors. Use this tool when you need to: - Retrieve all error occurrences (events) for a given project - Analyze individual error instances with timestamps and details - Get detailed exception information for debugging Prerequisites: Get the project_id first using BUGSNAG_LIST_PROJECTS. Note: Requires an active Bugsnag subscription (not available on expired trials).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `base` | string | No | Only events occurring before this ISO 8601 timestamp will be returned. Use for pagination. To paginate, set this to the timestamp of the last event received in the previous response to fetch the next page. |
| `sort` | string | No | Field to sort results by. Currently only 'timestamp' is supported. Default is 'timestamp'. |
| `filters` | object | No | Filters to restrict events. Each key is a field name, each value is a list of filter objects. Each filter object must have 'type' (eq/ne/empty) and 'value' keys. Multiple filters for the same field use OR logic; different fields use AND logic. Example: {"event.since":[{"type":"eq","value":"2024-01-01T00:00:00Z"}], "event.severity":[{"type":"eq","value":"error"}]} Malformed filter objects return HTTP 400 "filters parameter is not encoded correctly"; verify "type" and "value" keys are present on every filter object. |
| `per_page` | integer | No | Number of events to return per page (1-30). Default is 30. |
| `direction` | string | No | Sort direction: 'asc' for oldest first, 'desc' for newest first. Default is 'desc'. |
| `project_id` | string | Yes | The unique identifier of the project to retrieve events for. Get this from BUGSNAG_LIST_PROJECTS. |
| `full_reports` | boolean | No | If true, includes full error report payloads for each event. Default is false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organizations

**Slug:** `BUGSNAG_LIST_ORGANIZATIONS`

Tool to list organizations for the authenticated user. Use after validating the API token when you need to retrieve all organizations the current user has access to. Always resolve organization_id values from this tool's results rather than hardcoding them, as downstream tools like BUGSNAG_LIST_PROJECTS require valid organization_id values. Missing organizations in results indicate permission limitations of the authenticated account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (1-based). |
| `per_page` | integer | No | Number of organizations per page (maximum 100). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Teams

**Slug:** `BUGSNAG_LIST_ORGANIZATION_TEAMS`

Tool to list teams in an organization. Use when you need to retrieve teams for a specified Bugsnag organization, optionally filtered by team name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | A partial or full team name to filter the results by. |
| `offset` | string | No | Token to retrieve next page of results. |
| `per_page` | integer | No | Number of teams per page (default 30). |
| `organization_id` | string | Yes | ID of the organization to list teams for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pivots for Project

**Slug:** `BUGSNAG_LIST_PIVOTS_ON_PROJECT`

Lists all pivot field definitions for a Bugsnag project. Pivots are customizable fields used for filtering and grouping errors in Bugsnag dashboards. Use this to discover available pivot fields that can be used when querying errors or events. Note: This feature may require a paid Bugsnag subscription.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | The unique identifier of the Bugsnag project. Obtain this from BUGSNAG_LIST_PROJECTS action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Project Feature Flags

**Slug:** `BUGSNAG_LIST_PROJECT_FEATURE_FLAGS`

List feature flags on a Bugsnag project for a specific release stage. Use this to retrieve feature flags including their names, activity status, first seen timestamps, and optional variant summaries. Results can be filtered by search query, time frame, and activity status, and are paginated. Requires a valid project_id (from List Projects action) and release_stage_name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Search for feature flags with a name matching this query. Supports case-insensitive substring matching. |
| `sort` | string ("name" | "first_seen") | No | Field to sort feature flags by. |
| `per_page` | integer | No | How many results to return per page. Defaults to 30 if not specified. |
| `direction` | string ("asc" | "desc") | No | Direction to sort results. |
| `first_seen` | string ("all" | "this_week" | "today") | No | Time frame filter for when feature flags were first seen. |
| `project_id` | string | Yes | The unique identifier of the Bugsnag project. Obtain this from the List Projects action. |
| `starred_at_top` | boolean | No | Whether to return starred feature flags at the top of the list. Defaults to false if not specified. |
| `include_inactive` | boolean | No | Whether to include inactive feature flags (flags not seen in events in the last 7 days). Defaults to false if not specified. |
| `release_stage_name` | string | Yes | Release stage name to get the feature flags for (e.g., 'production', 'staging', 'development'). |
| `include_variant_summary` | boolean | No | Whether to include a summary of the variants for each feature flag. Defaults to false if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Project Feature Flag Summaries

**Slug:** `BUGSNAG_LIST_PROJECT_FEATURE_FLAG_SUMMARIES`

List feature flag summaries for a Bugsnag project with optional search filtering. Use this to retrieve feature flags that have been associated with errors in the project. Requires a valid project_id which can be obtained from the List Projects action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Search for feature flags with a name matching this query parameter. Supports case-insensitive substring matching. |
| `per_page` | integer | No | How many results to return per page. Defaults to 30 if not specified. |
| `project_id` | string | Yes | The unique identifier of the Bugsnag project. Obtain this from the List Projects action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Projects

**Slug:** `BUGSNAG_LIST_PROJECTS`

Tool to list projects in an organization. Use when you need to retrieve all projects under a specified Bugsnag organization after confirming the organization ID. Results may be paginated; iterate through all pages when an organization has many projects to ensure complete retrieval. Missing projects may indicate permission restrictions on the authenticated account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | The unique identifier of the Bugsnag organization. Obtain this from the List Organizations action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Release Groups

**Slug:** `BUGSNAG_LIST_RELEASE_GROUPS`

Tool to list release groups for a project. Use when you need to retrieve all release groups of a specific Bugsnag project after confirming the project ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | The unique identifier of the Bugsnag project to list release groups for. Can be obtained from BUGSNAG_LIST_PROJECTS. |
| `release_stage_name` | string | Yes | The release stage to filter release groups by (e.g., 'production', 'staging', 'development'). This parameter is required by the Bugsnag API. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Releases

**Slug:** `BUGSNAG_LIST_RELEASES`

List all releases (deployed versions) of a Bugsnag project. Releases track application versions, deployment stages, and associated source control information. Use this after obtaining a project_id from BUGSNAG_LIST_PROJECTS. Results can be filtered by release stage, time range, and paginated. Note: This feature requires a paid Bugsnag subscription.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Only include releases created after this ISO 8601 timestamp. |
| `limit` | integer | No | Maximum number of releases to return per page (default is API-defined, max 100). |
| `before` | string | No | Only include releases created before this ISO 8601 timestamp. |
| `offset` | integer | No | Number of releases to skip before returning results (for pagination). |
| `project_id` | string | Yes | The unique identifier of the Bugsnag project. Obtain this from BUGSNAG_LIST_PROJECTS. |
| `release_stage` | string | No | Filter releases by a specific release stage (e.g., 'production', 'staging', 'development'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Saved Searches on Project

**Slug:** `BUGSNAG_LIST_SAVED_SEARCHES_ON_PROJECT`

Lists all saved searches for a Bugsnag project. Saved searches are predefined filter configurations that help users quickly access specific error views. Use this to retrieve saved searches before getting or managing them. Requires a valid project_id from BUGSNAG_LIST_PROJECTS.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shared` | boolean | No | Filter saved searches by shared status. Set to true to get only shared searches, false for only private searches. Omit to get all saved searches. |
| `project_id` | string | Yes | The Bugsnag project ID (24-character hex string). Obtain this from BUGSNAG_LIST_PROJECTS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Supported Integrations

**Slug:** `BUGSNAG_LIST_SUPPORTED_INTEGRATIONS`

Tool to list all supported integrations. Use when discovering available integration services before configuring a project.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Trends for Project Buckets

**Slug:** `BUGSNAG_LIST_TRENDS_FOR_PROJECT_BUCKETS`

Retrieves time-segmented event counts (trend buckets) for a Bugsnag project. Use this to analyze error/event occurrence patterns over time by splitting the data into configurable time buckets. Requires an active paid Bugsnag subscription. NOTE: First retrieve project_id using BUGSNAG_LIST_PROJECTS.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Optional filters to restrict events in the trend. Keys are event field names (e.g., 'event.since' for time filters, 'error.status' for error status). Common filter: {'event.since': [{'value': '7d', 'type': 'eq'}]} for last 7 days. |
| `project_id` | string | Yes | ID of the project to retrieve trend buckets for |
| `buckets_count` | integer | No | Number of time buckets to divide the trend data into. Range: 1-50. Use 24 for hourly analysis, 7 for daily over a week, etc. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Regenerate Project API Key

**Slug:** `BUGSNAG_REGENERATE_PROJECT_API_KEY`

Regenerates a Bugsnag project's notifier API key. This action invalidates the old API key and generates a new one. Use this when you need to rotate API keys for security purposes. WARNING: After regeneration, all notifiers using the old API key will stop reporting errors until updated with the new key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | The unique identifier of the Bugsnag project whose notifier API key will be regenerated. You can get project IDs by using the 'List Projects' action with an organization_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Show Collaborator Access Details for Project

**Slug:** `BUGSNAG_SHOW_COLLABORATOR_ACCESS_DETAILS_FOR_PROJECT`

Tool to show a collaborator's access details for a project. Use after confirming organization, collaborator, and project IDs have been obtained and you have access rights.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | ID of the project. |
| `collaborator_id` | string | Yes | ID of the collaborator. |
| `organization_id` | string | Yes | ID of the Bugsnag organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Show Collaborator on Organization

**Slug:** `BUGSNAG_SHOW_COLLABORATOR_ON_ORGANIZATION`

Tool to show a collaborator in an organization. Use after confirming organization and collaborator IDs; requires Organization Administrator access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collaborator_id` | string | Yes | ID of the collaborator to show |
| `organization_id` | string | Yes | ID of the Bugsnag organization to fetch the collaborator from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Show Collaborator on Project

**Slug:** `BUGSNAG_SHOW_COLLABORATOR_ON_PROJECT`

Tool to show a collaborator in a project. Use when you need detailed information about a specific collaborator after confirming both project and collaborator IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | ID of the project to show the collaborator for |
| `collaborator_id` | string | Yes | Unique identifier of the collaborator to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test Integration

**Slug:** `BUGSNAG_TEST_INTEGRATION`

Tool to test an integration configuration before deploying it. Use when validating credentials and connection parameters for integrations like Jira, Slack, or Asana before creating a configured integration on a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | The key of the integration service to test (e.g., 'jira', 'slack', 'asana', 'github-issues'). The supported keys can be obtained from BUGSNAG_LIST_SUPPORTED_INTEGRATIONS. |
| `configuration` | object | Yes | Integration-specific configuration object containing credentials and connection parameters. Required fields depend on the integration - check BUGSNAG_LIST_SUPPORTED_INTEGRATIONS for details (e.g., for Jira: password, project_id, user_name). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Collaborator Permissions

**Slug:** `BUGSNAG_UPDATE_COLLABORATOR_PERMISSIONS`

Tool to update a collaborator's project access permissions. Use when you need to change which projects a collaborator can access or their roles within each project. Supply only project_ids or project_roles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_ids` | array | No | List of project IDs to grant access; mutually exclusive with project_roles |
| `project_roles` | object | No | Mapping of project IDs to roles (project_member or project_admin); mutually exclusive with project_ids |
| `collaborator_id` | string | Yes | The unique identifier of the collaborator whose permissions should be updated |
| `organization_id` | string | Yes | ID of the Bugsnag organization containing the collaborator |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
