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

# Create Investigation

Create a new investigation.

<Note>
  External Documentation

  To learn more, visit the [Rapid7 InsightIDR documentation](https://help.rapid7.com/insightidr/en-us/api/v2/docs.html#tag/Investigations/operation/createInvestigation).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter      | Description                                                         |
  | -------------- | ------------------------------------------------------------------- |
  | Assignee Email | The email address of the user to assign to the new investigation.   |
  | Disposition    | A disposition to set the investigation to. Defaults to `UNDECIDED`. |
  | Priority       | The priority to set to the investigation.                           |
  | Status         | The status to set for the investigation. Defaults to `OPEN`.        |
  | Title          | The title of the new investigation.                                 |
</div>

## Example Output

```json theme={"dark"}
{
	"rrn": "rrn:investigation:us1:174e4f99-2ac7-4481-9301-4d24c34baf06:investigation:6A74T2A4",
	"organization_id": "174e4f99-2ac7-4481-9301-4d24c34baf06",
	"title": "Jane Smith enabled account Roger Johnson",
	"source": "ALERT",
	"status": "OPEN",
	"priority": "CRITICAL",
	"last_accessed": "2018-06-06T16:56:42Z",
	"created_time": "2018-06-06T16:56:42Z",
	"disposition": "BENIGN",
	"assignee": {
		"name": "Ellen Example",
		"email": "example@test.com"
	},
	"first_alert_time": "2018-06-06T16:56:42Z",
	"latest_alert_time": "2018-06-06T16:56:42Z",
	"tags": [
		"Incident",
		"Security Test"
	],
	"responsibility": "CUSTOMER"
}
```

## Workflow Library Example

[Create Investigation with Rapid7 Insightidr and Send Results Via Email](https://library.blinkops.com/workflows/create-investigation-with-rapid7-insightidr-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-investigation-with-rapid7-insightidr-and-send-results-via-email/canvas" />
</div>