Get a study readout

The study's synthesized readout: objective, open questions, a narrative summary with stats, and the themes that emerged with representative quotes.

GET/v1/studies/{studyId}/readout

Example

curl -X GET "https://silent-viper-157.convex.site/v1/studies/study_789/readout" \  -H "Authorization: Bearer $ASKENGINE_API_KEY"

Response

{  "data": {    "studyId": "study_789",    "name": "Onboarding interviews Q4",    "status": "active",    "objective": "Understand where new teams stall in their first session.",    "openQuestions": [      "Does the checklist help teams who self-serve without sales?"    ],    "summary": {      "narrative": "New teams consistently stall at configuration, especially the API-key step; those who get past it activate quickly.",      "confidence": "high",      "suggestedNextQuestions": [        "What would have unblocked you fastest?"      ],      "stats": {        "totalSourceItems": 24,        "completionRate": 0.83,        "avgQualityScore": 0.86      },      "coverage": [        {          "targetId": "target_checklist",          "question": "Does the checklist help teams who self-serve without sales?",          "priority": "primary",          "substantiveSourceItems": 3,          "totalSourceItems": 24        }      ],      "lastUpdated": 1764687600000    },    "themes": [      {        "themeId": "thm_setup",        "label": "Setup friction",        "description": "Confusion around where and how to configure credentials.",        "sentiment": "negative",        "strength": "broad",        "trajectory": "rising",        "preview": [          {            "sourceItemId": "src_a1",            "quote": "I gave up twice before I figured out where to add my API key.",            "timeInCallSecs": 412,            "participantName": "Ada L."          }        ],        "distinctParticipants": 14      }    ],    "sourceItemCount": 24  }}