# Rollbar

Rollbar: items, occurrences, deploys, projects, access tokens. Exposes **22 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `rollbar_items_list` | List error items in a project - GET /projects/&#123;id&#125;/items. |
| `rollbar_item_get` | Get one error item - GET /projects/&#123;project_id&#125;/items/&#123;item_id&#125;. |
| `rollbar_item_update` | Update an error item - PATCH /projects/&#123;project_id&#125;/items/&#123;item_id&#125;. |
| `rollbar_item_status` | Update item status - PATCH /projects/&#123;project_id&#125;/items/&#123;item_id&#125;/status. |
| `rollbar_occurrences_list` | List occurrences (specific instances) of an item - GET /projects/&#123;project_id&#125;/items/&#123;item_id&#125;/occurrences. |
| `rollbar_occurrence_get` | Get one occurrence - GET /projects/&#123;project_id&#125;/occurrences/&#123;id&#125;. |
| `rollbar_deploys_list` | List deployments - GET /projects/&#123;project_id&#125;/deploys. |
| `rollbar_deploy_get` | Get one deploy - GET /projects/&#123;project_id&#125;/deploys/&#123;deploy_id&#125;. |
| `rollbar_deploy_report` | Report a new deployment - POST /projects/&#123;project_id&#125;/deploys. |
| `rollbar_projects_list` | List all projects - GET /projects. |
| `rollbar_project_get` | Get one project - GET /projects/&#123;id&#125;. |
| `rollbar_tokens_list` | List project access tokens - GET /projects/&#123;project_id&#125;/tokens. |
| `rollbar_token_create` | Create a project access token - POST /projects/&#123;project_id&#125;/tokens. |
| `rollbar_token_delete` | Delete a project access token - DELETE /projects/&#123;project_id&#125;/tokens/&#123;token_id&#125;. |
| `rollbar_rql_jobs_list` | List RQL (Rollbar Query Language) jobs - GET /projects/&#123;project_id&#125;/rql_jobs. |
| `rollbar_rql_job_get` | Get one RQL job - GET /projects/&#123;project_id&#125;/rql_jobs/&#123;job_id&#125;. |
| `rollbar_notifications_list` | List notifications/alerts - GET /projects/&#123;project_id&#125;/notifications. |
| `rollbar_notification_delete` | Delete a notification - DELETE /projects/&#123;project_id&#125;/notifications/&#123;notification_id&#125;. |
| `rollbar_users_list` | List all account users - GET /users. |
| `rollbar_user_get` | Get one user - GET /users/&#123;user_id&#125;. |
| `rollbar_invitations_list` | List pending account invitations - GET /invitations. |
| `rollbar_invite_user` | Invite a user to the account - POST /invitations. |

## How to get credentials

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

- **`ROLLBAR_ACCESS_TOKEN`** - Rollbar - Project Settings - Project Access Tokens (read/write). (https://rollbar.com/settings/accounts/)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `ROLLBAR_ACCESS_TOKEN` | Rollbar - Project Settings - Project Access Tokens (read/write). |

## 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

- [Rollbar API documentation](https://docs.rollbar.com/reference)
