kitaru session import
Upload a local payload or fetch from a provider API, and create an import job.
Usage
kitaru session import [FILE] [OPTIONS]Supported --output modes: auto, text, json, jsonl.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
FILE | path | No | Local payload file. Omit for an API import. |
Options
| Name | Type | Required | Description |
|---|---|---|---|
--importer | reference | Yes | Exact IMPORTER@VERSION reference. |
--agent | reference | Yes | Exact AGENT@VERSION reference. |
--params | JSON object | No | Importer parameters. |
--join-on | JSON Pointer | No | Group source traces by the value at this RFC 6901 JSON Pointer. |
--since | timestamp or duration | No | For an API import, fetch traces at or after this ISO 8601 timestamp or relative duration such as 7d, 12h, or 30m. |
--until | timestamp or duration | No | For an API import, fetch traces before this ISO 8601 timestamp or relative duration such as 7d, 12h, or 30m. |
--trace-id | text[] | No | For an API import, fetch exactly these provider trace ids. |
--query | JSON object | No | Additional importer-defined API selection fields, merged with --since, --until, and --trace-id. |
--connection | reference | No | For an API import, the connection UUID or name supplying provider credentials. |
--tag | text[] | No | Tag every session created by this import; requires --wait. |
--evaluator | EVALUATOR@VERSION[] | No | Exact evaluator version scored against every imported session. |
--evaluator-params | EVALUATOR@VERSION=JSON_OBJECT[] | No | Parameters for a selected evaluator token. |
--analyzer | ANALYZER@VERSION[] | No | Exact analyzer version run once over every imported session. |
--analyzer-params | ANALYZER@VERSION=JSON_OBJECT[] | No | Parameters for a selected analyzer token. |
--analyzer-connection | ANALYZER@VERSION=CONNECTION[] | No | Connection for a selected analyzer token. |
--media-type | string | No | Payload media type. |
--max-sessions | integer | No | Stop the import after creating this many sessions. |
--wait | boolean | No | Wait for remote work settlement. |
--interval | positive float | No | Polling interval; requires --wait. |
--timeout | positive float | No | Local wait timeout; requires --wait. |
--idempotency-key | string | No | Retrying this exact invocation with the same key returns the original result instead of acting twice. |
Every command also accepts the global options listed on the CLI overview page.