---
title: "Changes to Create an Investigation"
method: POST
path: "/investigations"
---

# Changes to Create an Investigation

`POST /investigations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `615aa97a5ddb`: 4 breaking, 16 info

## Changes

- **2026-11-03** `615aa97a5ddb`: 4 breaking, 16 info
  - the request property `journey_alerts/items/agent_token` became required
  - the request property `journey_alerts/items/journey_alert_token` became required
  - the `entity_tokens` request property's minItems was increased to `1`
  - the `journey_alerts` request property's minItems was increased to `1`
  - added the new optional request property `investigation_status`
  - added the new optional request property `should_auto_assign`
  - added `subschema #1, subschema #2` to the request body `anyOf` list
  - the request property `investigation_state` became optional
  - the request property `journey_alerts` became optional
  - added the optional property `_embedded` to the response with the `201` status
  - added the optional property `archived_at` to the response with the `201` status
  - added the optional property `closed_at` to the response with the `201` status
  - added the optional property `created_at` to the response with the `201` status
  - added the optional property `investigation_token` to the response with the `201` status
  - added the optional property `name` to the response with the `201` status
  - added the optional property `outcome` to the response with the `201` status
  - added the optional property `source` to the response with the `201` status
  - added the optional property `state` to the response with the `201` status
  - added the optional property `type` to the response with the `201` status
  - added the optional property `updated_at` to the response with the `201` status

---

[Operation](https://skmtc.dev/alloy/apis/alloy-api/docs/investigations/post.md) - [API](https://skmtc.dev/alloy/apis/alloy-api.md) - [Page](https://skmtc.dev/alloy/apis/alloy-api/changes/investigations/post)