---
title: "Start Investigation"
method: POST
path: "/api/investigate"
---

# Start Investigation

`POST /api/investigate`

## Request

- Base URL: `https://api.gethesperai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gethesperai.com/api/investigate`
- Auth: none declared

Start an investigation from a manual upload of zero or more files.

A claim needs *something* to work from, but not necessarily a document — a
typed FNOL description on its own is enough. Files are optional so a
claims-team user can open a case from an email or phone note before any
paperwork arrives.

## Headers

- `X-Team-Id` string, nullable

## Request body `multipart/form-data`

- BodyStartInvestigationApiInvestigatePost
  - `files` string[], nullable
  - `claimant_name` string
  - `policy_number` string
  - `claim_amount` number
  - `description` string
  - `pipeline` string
  - `enabled_steps` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator.md) - [All operations](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator/llms.txt) - [OpenAPI document](https://skmtc.dev/gethesperai/apis/hesper-ai-claims-investigator/revisions/1a031ee6acf1?raw)