latestOpenAPI 3.0.02026-07-241220330.3 KB

405799de4d2a

Investigations

Create an Investigation

Manually creates a new Investigation

post/investigations

Request body

investigation_statestring required
investigation_typestring required
entity_tokensstring[] required
investigation_assignee_tokenstring

Listed by Get list of assignable agents. Assigns the new Investigation to an agent.

should_aggregate_alertsboolean

Setup if the automatic Alerts can be attached to the new Investigation later.

investigation_namestring
notestring

Example request

{
  "investigation_state": "alert_review",
  "investigation_type": "Fraud",
  "entity_tokens": [
    "P-1GoQALm40nPQSp7UVTJS"
  ],
  "journey_alerts": [
    {
      "agent_token": "AG-L83m6iTwcXdNg3CHndS4",
      "journey_alert_token": "JA-mhjlfS6nZe1G6HuvAKVq",
      "outcome": "Dismissed",
      "reason": "Passed manual checks",
      "note": "My note"
    }
  ],
  "investigation_assignee_token": "AG-L83m6iTwcXdNg3CHndS4",
  "investigation_name": "Investigation Nick Armstrong",
  "note": "My note",
  "tags": [
    {
      "tag_name": "Suspicious Activity"
    }
  ]
}

Response

Investigation

Schema required— unresolved $ref