ontora-cli 0.1.0

Ontora CLI — manage interview campaigns, transcripts, reports, and webhooks from the terminal.

Ontora CLI

Manage Ontora interview campaigns, transcripts, reports, and webhooks from the terminal.

Install

pip install ontora-cli
# or, from this repo:
cd cli && pip install -e .

Setup

ontora auth login           # Paste your API key (or set ONTORA_API_KEY)
ontora auth status          # Verify connection

Get an API key from the Ontora web app (Settings → API Keys) or via POST /v1/api-keys. You'll also need to know your workspace ID.

export ONTORA_WORKSPACE_ID=<uuid>
# or set per-command with --workspace

Campaigns

ontora campaigns list
ontora campaigns create --config campaign.yaml
ontora campaigns show <id>
ontora campaigns start <id>
ontora campaigns pause <id>

Config-as-code (YAML)

name: "Q2 Procurement Discovery"
goal: "Map end-to-end procurement workflow to identify automation opportunities"
channel: in_app_chat
duration_minutes: 30
interview_context_for_employee: >
  We're mapping how procurement works across the organization.
success_criteria: >
  Complete process map with step-level pain points from every department.

topics:
  - name: "Daily Workflow"
    goal: "Understand the step-by-step procurement process"
    priority: required
    success_threshold: "Can describe process end-to-end with tools used"
    sub_topics: ["intake", "approval", "vendor selection", "PO creation"]
    questions:
      - text: "Walk me through a typical purchase request"
        required: true
      - text: "What tools do you use at each step?"

contacts:
  - name: "Jane Smith"
    email: "[e-mail]"
    department: "Procurement"
    job_title: "Senior Buyer"
    seniority_level: 4
  # Or: { file: contacts.csv }

Transcripts and reports

ontora transcripts list <campaign-id>
ontora transcripts get <campaign-id> <conversation-id>
ontora transcripts export <campaign-id> [--output ./out]  # ZIP of .md files
ontora reports show <campaign-id>
ontora reports export <campaign-id> [--output report.md]

Graph RAG query

ontora query <campaign-id> "What are the top pain points across procurement?"

Webhooks

ontora webhooks list
ontora webhooks add https://your-app.example/hook --events interview.completed,campaign.completed
ontora webhooks test <id>
ontora webhooks remove <id>