Skip to main content
POST
Save a Trail investigation to the workspace

Authorizations

X-API-KEY
string
header
required

Authorization method required to allow user to access the api endpoints.

Body

application/json
title
string
required
Maximum string length: 200
Example:

"Peel chain from Binance hot wallet"

subject_type
enum<string>
Available options:
address,
transaction
subject_address
string
Maximum string length: 256
Example:

"0xabc..."

subject_network
string
Maximum string length: 256
Example:

"eth"

subject_tx_hash
string
Maximum string length: 256
Example:

"0xdef..."

status
enum<string>
Available options:
open,
archived
data
object

Trail canvas snapshot; validated leniently server-side

Example:

Response

201 - application/json
id
string
required
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

workspace_id
string
required
Example:

"workspace-123"

title
string
required
Example:

"Peel chain from Binance hot wallet"

status
enum<string>
required
Available options:
open,
archived
Example:

"open"

created_at
string
required
Example:

"2026-07-09T00:00:00.000Z"

updated_at
string
required
Example:

"2026-07-09T00:00:00.000Z"

data
object
required

Trail canvas snapshot (nodes, notes, canvas state)

Example:
subject_type
enum<string> | null
Available options:
address,
transaction
subject_address
string | null
Example:

"0xabc..."

subject_network
string | null
Example:

"eth"

subject_tx_hash
string | null
Example:

"0xdef..."

created_by
string | null
Example:

"analyst@range.org"

Last modified on July 22, 2026