OverviewAPI ReferenceResources
AI Generation

Generate feedback

Returns the saved feedback, or generates it when there is none. forceRefresh: true generates it again. Generating uses one AI credit. It is counted before the transcript is checked, so a 404, or a 400 for a call with fewer than 10 transcript segments, also uses one. Fires conversation.feedback.ready.

POST
/api/v1/conversations/{id}/feedback

Authorization

AuthorizationRequiredBearer <token>

A Convo API key: convo_ followed by 32 hex characters. Create it in the Convo desktop app under Settings → Convo API.

In: header

Request Body

application/jsonOptional
forceRefreshboolean
Default: false

Path Parameters

idRequiredstring

Conversation ID from List conversations

curl -X POST "https://www.itsconvo.com/api/v1/conversations/session_1773842400000/feedback" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "forceRefresh": false
  }'

Generated feedback

{
  "data": {
    "id": "session_1773842400000",
    "feedback": {
      "overallScore": 8.5,
      "topPriority": {
        "focus": "Pause before answering Bob's pushback",
        "quote": "Yeah no, we already considered that.",
        "reason": "The two interruptions both came when Bob raised retention risk, and both shut the topic down before he finished the thought. Holding the pause is the single change that unblocks the retention conversation next call.",
        "alternative": "That's a fair concern, Bob. Walk me through what you're seeing."
      },
      "strengths": [
        {
          "category": "clarity",
          "description": "Clear and structured presentation of quarterly results",
          "timestamp": "14:01",
          "quote": "Let's review the Q1 targets one by one."
        }
      ],
      "growthAreas": [
        {
          "category": "listening",
          "description": "Interrupted Bob twice during the retention discussion",
          "suggestion": "Pause for 2-3 seconds after others finish speaking before responding.",
          "timestamp": "14:12"
        }
      ],
      "categoryScores": {
        "clarity": 9,
        "listening": 7.5,
        "timeManagement": 8.5,
        "collaboration": 8,
        "decisionMaking": 9
      },
      "talkListenRatio": 45,
      "actionPlan": [
        "Practice active listening by pausing before responding",
        "Summarize others' points before adding your own"
      ],
      "stats": {
        "talkListenRatio": 45,
        "totalMinutes": 45
      }
    },
    "overallScore": 8.5,
    "userSpeakerName": "local",
    "createdAt": "2026-03-18T15:00:00.000Z",
    "cached": false
  }
}

Was this page helpful?

Generate keypoints

Returns the saved key points, or generates them when there are none. `forceRefresh: true` generates them again. Key points don't use AI credits. Generating fires `conversation.keypoints.ready`, plus `conversation.summary.ready` when there are sections and `conversation.action_items.ready` when there are action items.

Generate follow-up email

Drafts a follow-up email from the call. Each request uses one AI credit. A call that doesn't exist returns 404 without using one. The body is optional.