CH·02CLI reference

deeprelay requests export

Export the filtered request log as CSV

Synopsis

Exports the request log as CSV, with the same filters as deeprelay requests list (--key, --model, --surface, --status, --error-code, --client-request-id, --from, --to, --fallback). The export is not paged: it streams every matching row in the 90-day window, newest first.

The last three columns are requested_model, served_model and fallback_reason, so a spreadsheet can tell which requests a backup model answered. --fallback keeps only those requests. The per-model attempts trail is not exported; use deeprelay requests get for it.

The CSV goes to stdout, or to a file with --out . The file is written with owner-only permissions (0600), and is only created once the server has accepted the export, so a refused export leaves nothing behind. If the stream breaks partway, the partial file is removed.

Row limit. An export has a maximum row count. When your filters match more rows than that, nothing is exported: the command names the limit, tells you to narrow the time range or add a filter, and exits 1. Splitting a long range into several --from/--to exports always works.

Text cells that a spreadsheet could read as a formula are escaped on the server, so the file is safe to open directly.

Examples

# Last week's requests to a file
deeprelay requests export --from 2026-10-01 --to 2026-10-08 --out requests.csv

# Only the requests that fell back to a backup model
deeprelay requests export --fallback --from 2026-10-01 --out fallbacks.csv

# Only the rejected requests for one key, piped into another tool
deeprelay requests export --key 11111111-2222-3333-4444-555555555555 --status rejected | wc -l

deeprelay requests export [flags]

Options

      --client-request-id string   Only requests carrying this client request id
      --error-code string          Only requests that ended with this error code
      --fallback                   Only requests a backup model served or that tried backups
      --from string                Start of the time range (RFC3339 or YYYY-MM-DD, UTC); clamped to the 90-day window
  -h, --help                       help for export
      --key string                 Only requests made with this API key id
      --model string               Only requests for this model id
      --out string                 Write the CSV to this file (mode 0600) instead of stdout
      --status string              Only this status: ok | error | cancelled | rejected
      --surface string             Only this surface: chat | messages | responses | embeddings | image | video
      --to string                  End of the time range (RFC3339 or YYYY-MM-DD, UTC)

Options inherited from parent commands

      --api-base string   API base URL (override with DEEPRELAY_API_BASE env) (default "https://api.deeprelay.ai/v1")
      --debug             Enable debug logging to stderr
      --no-preflight      Skip the plan/credit check before inference requests (override with DEEPRELAY_NO_PREFLIGHT env)
  -o, --output string     Output format: table|json (default table on TTY, json otherwise) (default "table")

Synopsis

Examples

Options

Options inherited from parent commands

SEE ALSO