Skip to main content

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.

When a campaign reaches completed, Ontora runs a synthesis pipeline that converts the transcripts into four structured artifacts.

​
Cartography

A map of the processes that came up in conversation, grouped into categories, with statistics on how often each was mentioned and which contacts mentioned it. 
curl https://api.ontora.com/v1/interviews/$ID/cartography \
  -H "X-API-Key: $ONTORA_API_KEY"
Use cases:
  • Visualize the “shape” of a function in a process map UI.
  • Identify processes mentioned by every contact (consensus) versus a single contact (edge cases).

​
Roadmap

Proposed solutions grouped by horizon. Each phase contains opportunities sized by impact and effort. 
curl https://api.ontora.com/v1/interviews/$ID/roadmap \
  -H "X-API-Key: $ONTORA_API_KEY"
Use cases:
  • Hand straight to a product team as a starting point.
  • Filter for “now” horizon to seed a next-sprint backlog.

​
Personas

Per-contact behavioral profiles, optionally rolled up by department. Each persona captures observed characteristics, motivations, and frustrations grounded in the transcript. 
curl "https://api.ontora.com/v1/interviews/$ID/personas?department=Operations" \
  -H "X-API-Key: $ONTORA_API_KEY"

​
Conversations

A list of individual transcripts with one-paragraph summaries and metadata. 
curl "https://api.ontora.com/v1/interviews/$ID/conversations?status=completed" \
  -H "X-API-Key: $ONTORA_API_KEY"
For the full transcript text, see Export transcripts.

​
When does synthesis run?

Synthesis triggers automatically when the last conversation in a campaign reaches completed. You’ll receive a synthesis.completed webhook when it’s ready. To re-run synthesis (for example after editing the question set), call the campaign’s resync endpoint or wait for the next scheduled run.

​
Grounding

All synthesis is grounded — every assertion in the cartography, roadmap, and personas can be traced back to specific chunks in the source transcripts. The GraphRAG query endpoint returns those citations directly.