Summarize conversation transcripts | Makimoto

curl -X POST https://https//https/summarize \
     -H "apikey: {{apikey}}" \
     -H "Content-Type: application/json" \
     -d '{
  "transcripts": [
    "Agent: Hello, how can I help you today?\nCustomer: I have a billing issue."
  ],
  "call_uuid": "call-abc123",
  "callback_url": "https://https//hooks.example.com/cb"
}'

{
  "status": "S001",
  "call_uuid": "call-abc123",
  "data": {
    "summaries": [
      {
        "topic": "Billing Issue",
        "summary": "The customer contacted support for a billing issue. The agent offered help and resolved the issue."
      }
    ],
    "meta_data": {
      "prompt_tokens": 676,
      "completion_tokens": 35,
      "per_example_completion_tokens": [
        35
      ],
      "total_tokens": 711,
      "time_taken_secs": 8.100447,
      "time_per_example_secs": 8.100447,
      "msg_id": "089f4f5c-32b3-4e98-9e76-e3eeca7f6aaf"
    }
  }
}

Generate summaries for provided conversation transcripts.

Inline mode — omit callback_url: returns 200 OK with the summaries in data.

Async mode — set callback_url: returns 202 Accepted and POSTs the result to your callback_url when ready. See the summaryDelivered operation under Webhooks for the payload shape, retry policy, and correlation contract.

Request

This endpoint expects an object.

transcriptslist of stringsRequired

call_uuidstringRequired

callback_urlstringRequiredformat: "uri"

Response

Inline mode (no callback_url).

statusstring

call_uuidstring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error

504

Gateway Timeout Error

Headers

Request

Response

Errors