Convo
API ReferenceAI Generation

Query conversation

Ask a natural-language question about a conversation. AI-powered, counts against monthly limit.

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

Authorization

AuthorizationRequiredBearer <token>

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

In: header

Request Body

application/jsonRequired
queryRequiredstring

The question to ask

Maximum length: 500

Path Parameters

idRequiredstring

Conversation session ID

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

AI-generated answer

{
  "data": {
    "id": "sess_a1b2c3",
    "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 the retention campaign?",
      "What was the revenue growth percentage?"
    ]
  }
}