---
title: "Review and close an investigation"
method: PUT
path: "/investigations/{investigation_token}/review"
tags: ["Investigations"]
---

# Review and close an investigation

`PUT /investigations/{investigation_token}/review`

## Request

- Base URL: `https://sandbox.alloy.co/v1`
- URL: `https://sandbox.alloy.co/v1/investigations/{investigation_token}/review`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `/oauth/bearer`
  - HTTP basic
- TypeScript: <https://skmtc.dev/alloy/apis/alloy-api/docs/investigations/:investigation_token/review/put.ts> (a function with typed inputs; its response is checked against the schema)

Reviews an investigation and closes it.

## Request body

- object
  - `reason` string, required
  - `outcome` string, required
  - `note` string

## Response `200`

Success

- object
  - `error` object, nullable

## Other responses

- `400`: Missing required fields
- `404`: Investigation Not Found

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) - [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alloy/apis/alloy-api/revisions/615aa97a5ddb?raw)
