# BugSnag

BugSnag: organizations, projects, errors, events, releases, collaborators. Exposes **29 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `bugsnag_organizations_list` | List all organizations - GET /organizations. |
| `bugsnag_organization_get` | Get one organization - GET /organizations/{id}. |
| `bugsnag_projects_list` | List projects in an organization - GET /organizations/{org_id}/projects. |
| `bugsnag_project_get` | Get one project - GET /organizations/{org_id}/projects/{project_id}. |
| `bugsnag_project_create` | Create a new project - POST /organizations/{org_id}/projects. |
| `bugsnag_project_update` | Update a project - PATCH /organizations/{org_id}/projects/{project_id}. |
| `bugsnag_project_delete` | Delete a project - DELETE /organizations/{org_id}/projects/{project_id}. |
| `bugsnag_errors_list` | List errors in a project - GET /organizations/{org_id}/projects/{project_id}/errors. |
| `bugsnag_error_get` | Get one error - GET /organizations/{org_id}/projects/{project_id}/errors/{error_id}. |
| `bugsnag_error_update` | Update an error - PATCH /organizations/{org_id}/projects/{project_id}/errors/{error_id}. |
| `bugsnag_error_latest_event` | Get latest event for an error - GET /organizations/{org_id}/projects/{project_id}/errors/{error_id}/latest_event. |
| `bugsnag_events_list` | List events in a project - GET /organizations/{org_id}/projects/{project_id}/events. |
| `bugsnag_event_get` | Get one event - GET /organizations/{org_id}/projects/{project_id}/events/{event_id}. |
| `bugsnag_pivots_list` | List analytics pivots for a project - GET /organizations/{org_id}/projects/{project_id}/pivots. |
| `bugsnag_pivot_get` | Get one pivot/analytics data - GET /organizations/{org_id}/projects/{project_id}/pivots/{pivot_id}. |
| `bugsnag_releases_list` | List releases for a project - GET /organizations/{org_id}/projects/{project_id}/releases. |
| `bugsnag_release_get` | Get one release - GET /organizations/{org_id}/projects/{project_id}/releases/{release_id}. |
| `bugsnag_release_create` | Create a release - POST /organizations/{org_id}/projects/{project_id}/releases. |
| `bugsnag_release_update` | Update a release - PATCH /organizations/{org_id}/projects/{project_id}/releases/{release_id}. |
| `bugsnag_release_delete` | Delete a release - DELETE /organizations/{org_id}/projects/{project_id}/releases/{release_id}. |
| `bugsnag_collaborators_list` | List collaborators (team members) in an organization - GET /organizations/{org_id}/collaborators. |
| `bugsnag_collaborator_get` | Get one collaborator - GET /organizations/{org_id}/collaborators/{collaborator_id}. |
| `bugsnag_collaborator_create` | Invite a collaborator (user) to an organization - POST /organizations/{org_id}/collaborators. |
| `bugsnag_collaborator_delete` | Remove a collaborator from an organization - DELETE /organizations/{org_id}/collaborators/{collaborator_id}. |
| `bugsnag_comments_list` | List comments on an error - GET /organizations/{org_id}/projects/{project_id}/errors/{error_id}/comments. |
| `bugsnag_comment_get` | Get one comment - GET /organizations/{org_id}/projects/{project_id}/errors/{error_id}/comments/{comment_id}. |
| `bugsnag_comment_create` | Create a comment on an error - POST /organizations/{org_id}/projects/{project_id}/errors/{error_id}/comments. |
| `bugsnag_comment_delete` | Delete a comment - DELETE /organizations/{org_id}/projects/{project_id}/errors/{error_id}/comments/{comment_id}. |
| `bugsnag_stability_trend` | Get stability trend data for a project - GET /organizations/{org_id}/projects/{project_id}/stability_trend. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`BUGSNAG_AUTH_TOKEN`** - BugSnag - Settings - My account - Personal auth tokens. (https://app.bugsnag.com/settings/my-account)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `BUGSNAG_AUTH_TOKEN` | BugSnag - Settings - My account - Personal auth tokens. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [BugSnag API documentation](https://bugsnagapiv2.docs.apiary.io)