Convo
API ReferenceAI Generation

Generate feedback

Generates AI-powered communication feedback. Returns cached result if available. Requires at least 10 transcript segments.

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

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token. Generate keys in your Convo dashboard settings.

In: header

Request Body

application/jsonOptional
forceRefreshboolean
Default: false

Path Parameters

idRequiredstring

Conversation session ID

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

Generated feedback

{
  "data": {
    "id": "sess_a1b2c3",
    "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": 0.62,
      "actionPlan": [
        "Practice active listening by pausing before responding",
        "Summarize others' points before adding your own"
      ]
    },
    "overallScore": 8.5,
    "userSpeakerName": "Alice",
    "createdAt": "2026-03-18T15:00:00.000Z",
    "cached": false
  }
}