Convo API Docs

Generates AI-powered keypoints for a conversation. Returns cached result if available (no AI credit consumed). Use `forceRefresh: true` to regenerate.

Authorization

AuthorizationRequiredBearer <token>

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

In: header

Request Body

application/jsonOptional

forceRefreshboolean

Force regeneration even if cached result exists

Default: false

Path Parameters

idRequiredstring

Conversation session ID

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

Generated keypoints

{
  "data": {
    "id": "sess_a1b2c3",
    "title": "Q1 Planning Review",
    "keypoints": {
      "title": "Q1 Planning Review",
      "sections": [
        {
          "heading": "Revenue Performance",
          "points": [
            "Revenue increased 15% quarter-over-quarter",
            "Enterprise segment grew fastest at 22%"
          ]
        },
        {
          "heading": "Customer Retention",
          "points": [
            "Retention rate held steady at 94%",
            "Churn concentrated in SMB segment"
          ]
        }
      ],
      "decisions": [
        "Increase enterprise sales team by 2 headcount",
        "Launch SMB retention campaign by end of April"
      ],
      "actionItems": [
        {
          "item": "Draft enterprise hiring plan",
          "owner": "Alice",
          "confidence": 0.95,
          "priority": "high"
        },
        {
          "item": "Prepare SMB retention proposal",
          "owner": "Bob",
          "confidence": 0.87,
          "priority": "medium"
        }
      ],
      "participants": [
        "Alice",
        "Bob"
      ],
      "importantDates": [
        {
          "date": "2026-04-30",
          "context": "Deadline for SMB retention campaign launch"
        }
      ]
    },
    "createdAt": "2026-03-18T15:00:00.000Z",
    "cached": false
  }
}

Generate keypoints

Authorization

Request Body

Path Parameters

Response

TypeScript