Skip to content

Flow export and import

You can export recorded flows to share with other tools or team members, and import flows from previous sessions. yorishiro-proxy supports three export formats: JSONL, HAR 1.2, and cURL commands.

Export formats

JSONL format

JSONL (JSON Lines) is the native export format. Each line is a complete JSON object containing a flow and its messages. This format supports all protocols and flow types, including raw TCP and gRPC.

// manage
{
  "action": "export_flows",
  "params": {
    "format": "jsonl",
    "output_path": "/tmp/flows.jsonl"
  }
}

When output_path is omitted, small exports (up to 100 flows) are returned inline in the response:

// manage
{
  "action": "export_flows",
  "params": {
    "format": "jsonl"
  }
}

HAR 1.2 format

HAR (HTTP Archive) 1.2 is a standard format compatible with browser DevTools, Burp Suite, and OWASP ZAP. HAR export always requires a file path:

// manage
{
  "action": "export_flows",
  "params": {
    "format": "har",
    "output_path": "/tmp/flows.har"
  }
}

HAR limitations

HAR is an HTTP-specific format. Raw TCP and gRPC flows are excluded from HAR exports. WebSocket flows include a _webSocketMessages custom field. Binary bodies are Base64-encoded with content.encoding: "base64".

cURL command format

Export individual flows as cURL commands using the query tool:

// query
{
  "action": "curl",
  "params": {
    "flow_id": "abc-123"
  }
}

Filtering exports

Apply filters to export a subset of flows:

// manage
{
  "action": "export_flows",
  "params": {
    "format": "jsonl",
    "filter": {
      "protocol": "HTTPS",
      "url_pattern": "/api/",
      "time_after": "2026-02-01T00:00:00Z",
      "time_before": "2026-02-28T23:59:59Z"
    },
    "output_path": "/tmp/api-flows.jsonl"
  }
}

Filter fields

Field Type Description
protocol string Filter by protocol (e.g. "HTTPS", "HTTP/1.x", "WebSocket")
url_pattern string Filter by URL substring
time_after string Include flows after this time (RFC3339 format)
time_before string Include flows before this time (RFC3339 format)

Metadata-only export

Export flow metadata without message bodies for a lightweight overview:

// manage
{
  "action": "export_flows",
  "params": {
    "format": "jsonl",
    "include_bodies": false,
    "output_path": "/tmp/flows-meta.jsonl"
  }
}

Importing flows

Import flows from a JSONL file. Each line must be a valid export record with version "1":

// manage
{
  "action": "import_flows",
  "params": {
    "input_path": "/tmp/flows.jsonl"
  }
}

Conflict handling

When importing flows with IDs that already exist in the store, use on_conflict to control behavior:

Policy Description
skip Skip flows with existing IDs (default)
replace Delete existing flows and re-import 
// manage
{
  "action": "import_flows",
  "params": {
    "input_path": "/tmp/flows.jsonl",
    "on_conflict": "replace"
  }
}

Import result

The import action returns:

Field Description
imported Number of flows successfully imported
skipped Number of flows skipped due to conflicts
errors Number of flows that failed to import
source Absolute path of the import file
error_details Details of any import errors

Practical use cases

Export for external analysis

Export HTTPS flows to HAR for analysis in Burp Suite:

// manage
{
  "action": "export_flows",
  "params": {
    "format": "har",
    "filter": {"protocol": "HTTPS"},
    "output_path": "/tmp/analysis.har"
  }
}

Session backup

Export all flows from a testing session:

// manage
{
  "action": "export_flows",
  "params": {
    "format": "jsonl",
    "output_path": "/tmp/session-backup.jsonl"
  }
}

Restore a session

Import a previous session's flows:

// manage
{
  "action": "import_flows",
  "params": {
    "input_path": "/tmp/session-backup.jsonl",
    "on_conflict": "skip"
  }
}

Time-scoped export

Export flows from a specific time window:

// manage
{
  "action": "export_flows",
  "params": {
    "format": "jsonl",
    "filter": {
      "time_after": "2026-03-14T09:00:00Z",
      "time_before": "2026-03-14T17:00:00Z"
    },
    "output_path": "/tmp/today.jsonl"
  }
}