OverviewAPI ReferenceResources
AI Generation

Query conversation

Answers a question about one call from its transcript. Each request uses one AI credit. A call that doesn't exist returns 404 without using one. suggestedQueries are fixed follow-up questions picked from words in your question.

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

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/jsonRequired
queryRequiredstring

The question to ask

Maximum length: 500

Path Parameters

idRequiredstring

Conversation ID from List conversations

curl -X POST "https://www.itsconvo.com/api/v1/conversations/session_1773842400000/query" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What were the main action items?"
  }'

AI-generated answer

{
  "data": {
    "id": "session_1773842400000",
    "query": "What were the main action items?",
    "response": "Two action items were identified: (1) Alice will draft an enterprise hiring plan by next week, and (2) Bob will prepare an SMB retention proposal by end of April.",
    "metadata": {
      "segmentsAnalyzed": 187,
      "conversationDuration": 45
    },
    "suggestedQueries": [
      "Who is responsible for each task?",
      "What are the deadlines?",
      "Draft an email summarizing this meeting"
    ]
  }
}

Was this page helpful?

Generate follow-up email

Drafts a follow-up email from the call. Each request uses one AI credit. A call that doesn't exist returns 404 without using one. The body is optional.

Get a contact briefing

Everything Convo Memory has on one contact before your next call: the relationship summary, recent meetings, open action items and recent decisions. Requires a Professional or Enterprise plan with Convo Memory enabled. Without Memory, it returns 403. A contact from another account returns 404.