Skip to main content
POST
/
v1
/
interviews
/
{interview_id}
/
graph
/
query
Query Interview Graph
curl --request POST \
  --url https://api.ontora.com/v1/interviews/{interview_id}/graph/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "anonymize": false,
  "top_k": 20,
  "conversation_history": [
    {
      "role": "<string>",
      "content": "<string>"
    }
  ]
}
'
{
  "answer": "<string>",
  "patterns": [
    {
      "theme": "<string>",
      "description": "<string>",
      "mention_count": 123,
      "total_respondents": 123,
      "percentage": 123,
      "departments_affected": [
        "<string>"
      ],
      "supporting_passage_keys": [
        "<string>"
      ]
    }
  ],
  "divergences": [
    {
      "topic": "<string>",
      "position_a": "<string>",
      "sources_a": [
        "<string>"
      ],
      "departments_a": [
        "<string>"
      ],
      "position_b": "<string>",
      "sources_b": [
        "<string>"
      ],
      "departments_b": [
        "<string>"
      ],
      "magnitude": "<string>"
    }
  ],
  "provenance": [
    {
      "claim": "<string>",
      "passages": [
        {
          "key": "<string>",
          "text": "<string>",
          "contact_name": "<string>",
          "department": "<string>",
          "job_title": "<string>",
          "seniority_level": 123,
          "similarity_score": 0
        }
      ]
    }
  ],
  "verification": {
    "passed": true,
    "department_coverage": 123,
    "departments_hit": [
      "<string>"
    ],
    "departments_missing": [
      "<string>"
    ],
    "passage_count": 123,
    "unique_contacts": 123
  },
  "query_complexity": "<string>",
  "strategies_used": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.ontora.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-API-Key
string | null

Path Parameters

interview_id
string<uuid>
required

Body

application/json
query
string
required
anonymize
boolean
default:false
top_k
integer
default:20
conversation_history
ConversationMessage · object[] | null

Response

Successful Response

answer
string
required
patterns
PatternOut · object[]
required
divergences
DivergenceOut · object[]
required
provenance
ProvenanceLinkOut · object[]
required
verification
VerificationOut · object
required
query_complexity
string
required
strategies_used
string[]
required