> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HackerOne

> Reference for the Tracecat HackerOne integration: registered actions, required secrets, expected inputs, and example workflow usage.

## Get program

Action ID: `tools.hackerone.get_program`

Get details of a specific program from HackerOne.

Reference: [https://api.hackerone.com/customer-resources/?python#programs-get-program](https://api.hackerone.com/customer-resources/?python#programs-get-program)

### Secrets

Required secrets:

* `hackerone`: required values `HACKERONE_API_USERNAME`, `HACKERONE_API_TOKEN`.

### Input fields

<ParamField path="program_id" type="integer" required>
  The ID of the program to retrieve.
</ParamField>

## Get programs

Action ID: `tools.hackerone.get_programs`

Get a paginated list of programs from HackerOne.

Reference: [https://api.hackerone.com/customer-resources/?python#programs-get-programs](https://api.hackerone.com/customer-resources/?python#programs-get-programs)

### Secrets

Required secrets:

* `hackerone`: required values `HACKERONE_API_USERNAME`, `HACKERONE_API_TOKEN`.

### Input fields

<ParamField path="page_number" type="integer">
  The page number to retrieve (starts at 1).

  Default: `1`.
</ParamField>

<ParamField path="page_size" type="integer">
  Number of programs per page (1-100).

  Default: `25`.
</ParamField>

## Get report

Action ID: `tools.hackerone.get_report`

Get details of a specific report from HackerOne.

Reference: [https://api.hackerone.com/customer-resources/?python#reports-get-report](https://api.hackerone.com/customer-resources/?python#reports-get-report)

### Secrets

Required secrets:

* `hackerone`: required values `HACKERONE_API_USERNAME`, `HACKERONE_API_TOKEN`.

### Input fields

<ParamField path="report_id" type="integer" required>
  The ID of the report to retrieve.
</ParamField>

## Get reports

Action ID: `tools.hackerone.get_reports`

Get a paginated list of reports from HackerOne.

Reference: [https://api.hackerone.com/customer-resources/?python#reports-update-weakness](https://api.hackerone.com/customer-resources/?python#reports-update-weakness)

### Secrets

Required secrets:

* `hackerone`: required values `HACKERONE_API_USERNAME`, `HACKERONE_API_TOKEN`.

### Input fields

<ParamField path="filters" type="object" required>
  Filters to apply to the reports. For example, \{'filter\[program]\[]': 'tracecat', 'filter\[state]\[]': \['new', 'triaged'], 'filter\[assignee]\[]': 'Tracecat Team'}
</ParamField>

<ParamField path="page_number" type="integer">
  The page number to retrieve (starts at 1).

  Default: `1`.
</ParamField>

<ParamField path="page_size" type="integer">
  Number of reports per page (1-100).

  Default: `25`.
</ParamField>