Convo
API ReferenceConversations

Get cached keypoints

GET
/api/v1/conversations/{id}/keypoints

Authorization

AuthorizationRequiredBearer <token>

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

In: header

Path Parameters

idRequiredstring

Conversation session ID

curl -X GET "https://www.itsconvo.com/api/v1/conversations/sess_a1b2c3/keypoints" \
  -H "Authorization: Bearer <token>"

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