---
title: "Promote Investigation Alert to Case Review"
method: PUT
path: "/investigations/{investigation_token}/promote"
tags: ["Investigations"]
---

# Promote Investigation Alert to Case Review

`PUT /investigations/{investigation_token}/promote`

## Request

- Base URL: `https://sandbox.alloy.co/v1`
- URL: `https://sandbox.alloy.co/v1/investigations/{investigation_token}/promote`
- 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/promote/put.ts> (a function with typed inputs; its response is checked against the schema)

Promotes an Investigation from Alert Review to Case Review.

## Request body

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

## Response `200`

Success

- GetInvestigationDetails
  - `investigation_token` string
  - `closed_at` string, date-time
  - `created_at` string, date-time
  - `name` string, nullable
  - `type` string
  - `state` string
  - `source` string
  - `outcome` string
  - `updated_at` string, date-time
  - `archived_at` string, date-time
  - `_embedded` object
    - `assigned_agent` object
      - `first_name` string
      - `last_name` string
      - `email` string
      - `token` string
    - `entities` object
      - `P-KaKZxdSGnbxXfKXnXdyp` object
        - `type` string
        - `entity_token` string
        - `entity_name` string
        - `meta` string, nullable
        - `external_ingestion_identifier` string, nullable
        - `recent_action` string, nullable
        - `external_entity_identifier` string
        - `risk_score` number, nullable
    - `events` object[]
      - `event` string
      - `agent` object
        - `first_name` string
        - `last_name` string
        - `email` string
        - `token` string
      - `assigned_agent` object
        - `first_name` string, nullable
        - `last_name` string, nullable
        - `email` string, nullable
        - `token` string, nullable
      - `note` string, nullable
      - `meta` object, nullable
    - `evidences` object
      - `journey_alerts` object[]
        - `journey_application_token` string
        - `journey_token` string
      - `tags` object[]
        - `tag_color` string
        - `tag_name` string
        - `is_outcome_reason` boolean
        - `added_by` object
          - `email` string
          - `first_name` string
          - `last_name` string
          - `token` string
    - `documents` Document[]
      - `document_token` string
      - `type` 'contract' | 'license' | 'passport' | 'utility' | 'other' | 'internal' | 'identification_card' | 'residence_permit' | 'canada_provincial_id' | 'indigenous_card' | 'paystub' | 'bank_statement' | 'w2' | '1099' | '1120' | '1065' | 't1' | 't4' | 'w9' | 'deposited_check' | 'voided_check' | 'social_security_card' | 'h1b' | 'passport_card' | 'credit_report' | 'iso_app' | 'brokerage_statement' | 'lease' | 'document' | 'ucc1' | 'incorporation_certificate' | 'good_standing_certificate'
      - `name` string
      - `extension` string
      - `uploaded` boolean
      - `timestamp` number
      - `approved` string
      - `approval_agent_email` string
      - `approval_timestamp` number
      - `notes` DocumentNotes[]
        - `note` string
        - `note_author_agent_email` string
        - `created_at` number
        - `updated_at` number
    - `notes` object[]
      - `created_at` string
      - `created_by` object
        - `first_name` string
        - `last_name` string
        - `email` string
        - `token` string
      - `entity_name` string
      - `entity_token` string
      - `text` string
      - `is_investigation_level_note` boolean
    - `reviews` object[]
      - `new_investigation_state` string
      - `note` string, nullable
      - `outcome` string
      - `previous_investigation_state` string
      - `reason` string
      - `reviewed_at` string, date-time
      - `reviewed_by` object
        - `first_name` string
        - `last_name` string
        - `email` string
        - `token` string

## Other responses

- `404`: Investigation Not Found

## Changes

- **2026-11-03** `615aa97a5ddb`: 1 breaking, 13 info
  - the response's body type changed from no type to `object` for status `200`
  - added `#/components/schemas/InvestigationsNotFound` to the response body `allOf` list for the response status `404`
  - removed `#/components/schemas/schema` from the response body `allOf` list for the response status `404`
  - added the optional property `_embedded` to the response with the `200` status
  - …10 more

[Operation history](https://skmtc.dev/alloy/apis/alloy-api/changes/investigations/:investigation_token/promote/put.md)

---

[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)