Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nusomi.com/llms.txt

Use this file to discover all available pages before exploring further.

The memory graph is per-workspace, per-workflow. See memory graph concepts for the model.

​
Paths

GET /v1/memory/paths?workflow=process_invoice&since=30d
ParamNotes
workflowRequired.
since / untilISO or relative.
outcomesuccess | error | abandoned.
min_frequencyDrop paths below threshold (e.g. 0.01).
limit1–500.
{
  "data": [
    {
      "path_id": "pth_01HZ...",
      "node_ids": ["nde_a", "nde_b", "nde_c"],
      "frequency": 0.62,
      "outcomes": { "success": 0.91, "error": 0.07, "abandoned": 0.02 },
      "median_duration_ms": 84_300,
      "session_count": 412
    }
  ]
}

​
Outliers

GET /v1/memory/outliers?workflow=process_invoice&threshold=0.05
Returns sessions whose path frequency is below the threshold. Same shape as the sessions list.

​
Similar sessions

POST /v1/memory/similar

{
  "session_id": "ses_01HZ...",
  "limit": 10
}
Returns sessions ranked by graph-shape similarity. Useful when triaging a failure (“show me ten runs that took the same path”).

​
Recovery points

GET /v1/memory/recovery_points?workflow=process_invoice&failure_tag=validation_error
Returns the frame ids most commonly used as recovery anchors for a given failure mode. Each recovery point includes a frequency and the median time-to-success from that anchor. 
{
  "data": [
    {
      "frame_id": "frm_01HZ...",
      "session_id": "ses_01HZ...",
      "frequency": 0.71,
      "median_recovery_ms": 18_400
    }
  ]
}

​
Drift subscription

Drift events are delivered via webhooks. Subscribe with: 
POST /v1/webhooks

{
  "url": "https://acme.com/hooks/nusomi-drift",
  "events": ["memory.drift.new_node", "memory.drift.path_disappeared"]
}

​
Disabling the graph

PATCH /v1/workflows/process_invoice

{ "memory_graph": false }
Existing sessions remain queryable individually. No new graph nodes are created. Re-enable to start indexing again from that point on.