OverviewAPI ReferenceResources
AI Generation

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.

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

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

Force regeneration even if cached result exists

Default: false

Path Parameters

idRequiredstring

Conversation ID from List conversations

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

Generated keypoints

{
  "data": {
    "id": "session_1773842400000",
    "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
  }
}

Was this page helpful?

Delete conversation

Deletes the call. It no longer appears in the API or the app, and it is unlinked from your Convo Memory contacts. The API can't restore it. Fires `conversation.deleted`.

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`.