# Honeybadger

Honeybadger is an error tracking and application performance monitoring service for developers.

- **Category:** server monitoring
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `HONEYBADGER`
- **Version:** 20260313_00

## Tools

### Report Check-In

**Slug:** `HONEYBADGER_REPORT_CHECK_IN`

Reports a check-in (ping) to Honeybadger for uptime monitoring. Check-ins are used to monitor scheduled tasks, cron jobs, and background processes. By pinging this endpoint regularly, you signal that your task is running on schedule. If Honeybadger doesn't receive a ping within the expected timeframe, it will alert you that the task may have failed or stopped running. Use this action at the end of successful task executions to notify Honeybadger the task completed as expected.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | The unique identifier of the check-in to report. Provide this OR `project_api_key` and `slug`. |
| `slug` | string | No | The slug identifier of the check-in. Required when reporting by slug instead of `id`. |
| `project_api_key` | string | No | The API key of the project. Required when reporting by `slug` instead of `id`. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Report Check-In With Payload

**Slug:** `HONEYBADGER_REPORT_CHECK_IN_WITH_PAYLOAD`

Report a check-in with additional payload data to Honeybadger. Use when monitoring scheduled tasks or cron jobs and need to send metrics, status, or metadata (up to 20KB).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `check_in` | object | Yes | Check-in payload data containing metrics, status, or other metadata (max 20KB total) |
| `check_in_id` | string | Yes | The unique identifier of the check-in to report. This acts as authentication for the check-in endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Report Deployment

**Slug:** `HONEYBADGER_REPORT_DEPLOYMENT`

Report a new deployment to Honeybadger for deployment tracking and error correlation. Use this tool after deploying code to notify Honeybadger, which allows you to: - Track deployment history on your project's Deployments page - Correlate errors with specific deployments - Automatically resolve errors when deploying to an environment All deployment fields are optional, but providing environment and revision is recommended for better tracking.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deploy` | object | Yes | Deployment details including environment, revision, repository, and username. All fields are optional but providing more details helps track deployments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Report Event

**Slug:** `HONEYBADGER_REPORT_EVENT`

Send custom events to Honeybadger Insights for tracking, monitoring, and analytics. Use this action to record any structured event data such as: - User activity and behavioral events (logins, page views, feature usage) - Application errors and exceptions with context - Performance metrics and timing data - Custom business events and audit trails - System health and operational metrics Events are sent as newline-delimited JSON (NDJSON) and can include any custom fields. The API returns tracking IDs for each successfully recorded event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `events` | array | Yes | List of event objects to send to Honeybadger Insights. Each event is a flexible dictionary that can contain any fields relevant to your tracking needs (e.g., event name, user_id, timestamps, custom metadata). Common patterns include: error events with error_type/message fields, user activity events with user_id/action fields, or performance metrics with timing data. Size constraints: each event < 100 kB, total payload < 5 MB. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Report Exception

**Slug:** `HONEYBADGER_REPORT_EXCEPTION`

Tool to report an exception notice to Honeybadger. Use when sending error details (stack trace, context) for diagnostics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `error` | object | Yes | Exception details including backtrace |
| `server` | object | No | Server and process context for the exception. |
| `request` | object | No | HTTP request context at the time of the exception. |
| `notifier` | object | No | Client library information for Honeybadger notifier. |
| `breadcrumbs` | object | No | Breadcrumb trail leading up to the exception. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Upload File to S3

**Slug:** `HONEYBADGER_UPLOAD_FILE_TO_S3`

Tool to upload a local file to a managed S3 bucket. Use when preparing files for source-map uploads.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mimetype` | string | No | Optional MIME type of the file. |
| `file_path` | string | Yes | Absolute path to the local file to upload. |
| `desired_name` | string | No | Optional filename to use in S3. Defaults to basename of file_path. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Upload Source Map

**Slug:** `HONEYBADGER_UPLOAD_SOURCE_MAP`

Upload JavaScript source maps to Honeybadger for error stack trace de-minification. Use this tool after deploying minified JavaScript assets to enable Honeybadger to display un-minified, readable stack traces when errors occur. Source maps allow Honeybadger to map minified code back to your original source code with proper file names, function names, and line numbers. The tool uploads: (1) the minified JS file, (2) its corresponding .map file, and optionally (3) additional source files referenced by the map, all associated with the production URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `revision` | string | No | Deploy revision identifier (e.g., Git commit SHA, version tag) for tracking which deployment this source map applies to. Should match the revision configured in honeybadger.js. Defaults to 'master' if not provided. |
| `source_map` | object | Yes | The corresponding source map file (.map). |
| `minified_url` | string | Yes | Absolute production URL of the minified JS file in production; supports '*' wildcard for domain/protocol matching. Query strings are ignored. Example: 'https://cdn.example.com/app.min.js' or 'https://*/assets/app.min.js' |
| `minified_file` | object | Yes | The minified JavaScript file to upload. |
| `additional_source_files` | array | No | Additional original source files referenced by the source map. Each filename must match the source file's production URL path. Used when source map references files not embedded inline. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |