Convo API Docs

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

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,
      "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
  }
}

Generate feedback

Authorization

Request Body

Path Parameters

Response

TypeScript