---
title: "Create an Investigation"
method: POST
path: "/investigations"
tags: ["Investigations"]
---

# Create an Investigation

`POST /investigations`

Manually creates a new Investigation

## Request body

- object
  - `investigation_state` string, required — Listed by [Get Investigation filters](https://developer.alloy.com/public/reference/get_investigations-filters).
  - `investigation_type` string, required — Listed by [Get Investigation types](https://developer.alloy.com/public/reference/get_investigations-types).
  - `entity_tokens` string[], required
  - `journey_alerts` object[], required
    - `agent_token` string
    - `journey_alert_token` string
    - `outcome` string
    - `reason` string
    - `note` string
  - `investigation_assignee_token` string — Listed by [Get list of assignable agents](https://developer.alloy.com/public/reference/get_investigations-assignable-agents). Assigns the new Investigation to an agent.
  - `should_aggregate_alerts` boolean — Setup if the automatic Alerts can be attached to the new Investigation later.
  - `investigation_name` string
  - `note` string
  - `tags` object[]
    - `tag_name` string, required
    - `is_outcome_reason` boolean, required — If the tag has outcomes attached

## Response `201`

Investigation

- Schema — unresolved $ref

## Other responses

- `400` — Missing required fields

---

[API](https://skmtc.net/alloy/apis/alloy-api.md) · [All operations](https://skmtc.net/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)