Bugsnag

Learn how to use Bugsnag with Composio

Overview

SLUG: BUGSNAG

Description

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

Authentication Details

generic_api_key
stringRequired

Connecting to Bugsnag

Create an auth config

Use the dashboard to create an auth config for the Bugsnag toolkit. This allows you to connect multiple Bugsnag accounts to Composio for agents to use.

1

Select App

Navigate to the Bugsnag toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2from composio.types import auth_scheme
3
4# Replace these with your actual values
5bugsnag_auth_config_id = "ac_YOUR_BUGSNAG_CONFIG_ID" # Auth config ID created above
6user_id = "0000-0000-0000" # UUID from database/app
7
8composio = Composio()
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11 # Replace this with a method to retrieve an API key from the user.
12 # Or supply your own.
13 user_api_key = input("[!] Enter API key")
14
15 connection_request = composio.connected_accounts.initiate(
16 user_id=user_id,
17 auth_config_id=auth_config_id,
18 config={"auth_scheme": "API_KEY", "val": user_api_key}
19 )
20
21 # API Key authentication is immediate - no redirect needed
22 print(f"Successfully connected Bugsnag for user {user_id}")
23 print(f"Connection status: {connection_request.status}")
24
25 return connection_request.id
26
27
28connection_id = authenticate_toolkit(user_id, bugsnag_auth_config_id)
29
30# You can verify the connection using:
31connected_account = composio.connected_accounts.get(connection_id)
32print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Bugsnag toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["BUGSNAG"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: List Errors on Project

Description

Tool to list all errors in a project. use when you need to retrieve errors with optional filtering by version and sorting.

Action Parameters

direction
string
project_id
stringRequired
sort
string
version_seen_in
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Bulk Update Errors

Description

Tool to bulk update multiple errors in a project. use when batching identical updates across many errors.

Action Parameters

assigned_collaborator_id
string
assigned_team_id
string
error_ids
arrayRequired
issue_title
string
issue_url
string
notification_id
string
operation
stringRequired
project_id
stringRequired
reopen_rules
object
severity
string
verify_issue_url
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Configure Integration

Description

Tool to configure a new integration for a bugsnag project. use after selecting integration key and preparing credentials.

Action Parameters

configuration
objectRequired
disable_release_stages
array
disable_severities
array
disable_unhandled_states
array
integration_connection_id
string
integration_key
stringRequired
issue_automation
object
label
string
project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Invite Collaborator

Description

Tool to invite a collaborator to an organization. use when you need to add a new user by email to grant them access. ensure the organization id is correct before calling.

Action Parameters

admin
boolean
email
Required
organization_id
stringRequired
project_ids
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Custom Event Field

Description

Tool to create a custom event field for a project. use after confirming the project id to add a new filterable field. example: "create a field 'user.id' mapping to 'metadata.user.id' for project 515fb..."

Action Parameters

filter_options
objectRequired
path
stringRequired
pivot_options
object
project_id
stringRequired
reindex
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete All Errors in a Project

Description

Tool to delete all errors in a project. use when you need to remove all error and event data for a given project. use with caution after confirming the project id, as this action is irreversible and requires project owner or organization administrator permissions.

Action Parameters

project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Collaborator

Description

Tool to remove a collaborator from an organization. use when revoking collaborator access after confirming both organization and collaborator ids. requires organization administrator privileges.

Action Parameters

collaborator_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete a configured integration

Description

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.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Event Field

Description

Tool to delete a custom event field. use when you need to remove a specific event field after confirming the project id and display id.

Action Parameters

display_id
stringRequired
project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Project

Description

Tool to delete a project. use when you need to permanently remove a project after confirming the project id. requires appropriate permissions.

Action Parameters

project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Saved Search Usage Summary

Description

Tool to get usage summary for a saved search. use after confirming the saved search id. example: "get usage summary for saved search 515fb9337c1074f6fd000003".

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Collaborators

Description

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".

Action Parameters

organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Collaborators on Project

Description

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".

Action Parameters

per_page
integer
project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Collaborator Access Details for Projects

Description

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

Action Parameters

collaborator_id
stringRequired
inaccessible
boolean
individual_only
boolean
organization_id
stringRequired
per_page
integer
q
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Configured Integrations for Project

Description

Tool to list configured integrations for a project. use after confirming the project id to retrieve all integration summaries.

Action Parameters

project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Events on Project

Description

Tool to list events for a project. use when you need to retrieve all error occurrences (events) for a given project after confirming its id. example: "list events for project 515fb9337c1074f6fd000003".

Action Parameters

base
string
direction
string
filters
object
full_reports
boolean
per_page
integer
project_id
stringRequired
sort
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Event Fields for Project

Description

Tool to list event fields for a project. use when you need to discover all available fields for filtering events in a specified project. example: "list event fields for project 515fb9337c1074f6fd000001".

Action Parameters

project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Organizations

Description

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.

Action Parameters

page
integer
per_page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Pivots for Project

Description

Tool to list pivots for a project. use when you need to retrieve all pivot definitions available in a specified project.

Action Parameters

project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Projects

Description

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.

Action Parameters

organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Releases

Description

Tool to list releases for a project. use when you need to retrieve all releases of a specific bugsnag project after confirming the project id.

Action Parameters

after
string
before
string
limit
integer
offset
integer
project_id
stringRequired
release_stage
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Release Groups

Description

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.

Action Parameters

project_id
stringRequired
release_stage_name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Saved Searches on Project

Description

Tool to list saved searches for a project. use after confirming project id to retrieve all saved searches, optionally filtering by shared flag.

Action Parameters

project_id
stringRequired
shared
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Supported Integrations

Description

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

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Regenerate Project API Key

Description

Tool to regenerate a project's api key. use after confirming the project id and when you need to rotate the notifier api key.

Action Parameters

project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Show Collaborator Access Details for Project

Description

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.

Action Parameters

collaborator_id
stringRequired
organization_id
stringRequired
project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Show Collaborator on Organization

Description

Tool to show a collaborator in an organization. use after confirming organization and collaborator ids; requires organization administrator access.

Action Parameters

collaborator_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Show Collaborator on Project

Description

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.

Action Parameters

id
stringRequired
project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Collaborator Permissions

Description

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.

Action Parameters

id
stringRequired
organization_id
stringRequired
project_ids
array
project_roles
object

Action Response

data
objectRequired
error
string
successful
booleanRequired