v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB

Investigations

Save a Trail investigation to the workspace

post/v2/investigations

Request body

titlestring required

subject_type'address' | 'transaction'

subject_addressstring

subject_networkstring

subject_tx_hashstring

status'open' | 'archived'

dataobject

Trail canvas snapshot; validated leniently server-side

Example request

{
  "title": "Peel chain from Binance hot wallet",
  "subject_address": "0xabc...",
  "subject_network": "eth",
  "subject_tx_hash": "0xdef...",
  "data": {
    "nodes": [],
    "notes": [],
    "canvas": {}
  }
}

Response

idstring required

workspace_idstring required

titlestring required

subject_type'address' | 'transaction' nullable

subject_addressstring nullable

subject_networkstring nullable

subject_tx_hashstring nullable

status'open' | 'archived' required

created_bystring nullable

created_atstring required

updated_atstring required

dataobject required

Trail canvas snapshot (nodes, notes, canvas state)

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "workspace_id": "workspace-123",
  "title": "Peel chain from Binance hot wallet",
  "subject_address": "0xabc...",
  "subject_network": "eth",
  "subject_tx_hash": "0xdef...",
  "status": "open",
  "created_by": "analyst@range.org",
  "created_at": "2026-07-09T00:00:00.000Z",
  "updated_at": "2026-07-09T00:00:00.000Z",
  "data": {
    "nodes": [],
    "notes": [],
    "canvas": {}
  }
}