Search transcripts by project ID, one compact row per transcript.
Usage
vf transcript search [flags]Examples
vf transcript search --project-id <id>Flags
--body string Request body as JSON (alternative to individual flags). Can also be provided via stdin.
--end-date string Only transcripts created at or before this day ('2026-06-30', to 23:59:59.999 UTC) or ISO 8601 timestamp.
--environment-alias string When provided, only transcripts from the environment with this alias are returned.
-f, --filters string list of values
-h, --help help for search
-p, --project-id string [required]
-r, --release-name string When provided, only transcripts from the release with this exact name (e.g. 'V1.02') are returned, as listed in the 'releases' of the environment. When several releases share the name, transcripts from all of them are returned. Applies within a single environment; the main environment is used when 'environmentAlias' is omitted. Cannot be combined with 'version: "draft"'.
--session-id string When provided, only transcripts from this conversation session are returned.
--skip int The number of results to skip, used for pagination.
--start-date string Only transcripts created at or after this day ('2026-06-01', from 00:00 UTC) or ISO 8601 timestamp.
-t, --take int Page size, 1 to 50. There is no 'limit'. Page with 'skip' while 'hasMore' is true. (default 20)
-v, --version-param string When provided, only transcripts from the draft or published version of the environment are returned. 'published' covers the current release and every past release. Applies within a single environment; the main environment is used when 'environmentAlias' is omitted. (options: draft, published)Global flags
These flags are inherited from the parent command and work on every invocation.
--agent-mode Enable structured errors and default TOON output for AI coding agents. Automatically enabled when a known agent environment is detected (CLAUDE_CODE, CURSOR_AGENT, etc.). Use --agent-mode=false to disable.
--color string Control colored output: auto (color when output is a TTY), always, or never. Respects NO_COLOR and FORCE_COLOR env vars. (default "auto")
-d, --debug Log request and response diagnostics to stderr
--dry-run Preview the request that would be sent without executing it (output to stderr)
-H, --header stringArray Set a custom HTTP request header (format: "Key: Value"). Can be specified multiple times.
--include-headers Include HTTP response headers in the output
-q, --jq string Filter and transform output using a jq expression (e.g., '.name', '.items[] | .id')
--no-interactive Disable all interactive features (auto-prompting, explorer auto-launch, TUI forms)
-o, --output-format string Specify the output format. Options: pretty, json, yaml, table, toon. (default "pretty")
--server-url string Override the default server URL
--timeout string HTTP request timeout (e.g., 30s, 5m, 100ms)
--token string Voiceflow bearer token
--usage Print the CLI Usage schema in KDL formatSee also
- vf transcript - Operations for transcript