​
Summaries

Summary endpoints generate period-based summaries from Telegram messages.

​
Summarize chat

POST /v1/summaries/chat

​
Summarize channel

POST /v1/summaries/channel
Required scope: 
summary.run

​
Request

{
  "source_ref": "https://t.me/Djipiti_hub",
  "started_at": "2026-04-01T00:00:00Z",
  "ended_at": "2026-04-13T23:59:59Z",
  "language": "en"
}

​
Fields

NameTypeRequiredDescription
source_refstringyesTelegram source reference
started_atdatetimeyesSummary period start
ended_atdatetimeyesSummary period end
languagestringyesOutput language, for example en or ru

​
Response

{
  "source_ref": "https://t.me/Djipiti_hub",
  "summary": "A concise summary of messages from the selected period.",
  "sections": [
    {
      "title": "Main topic",
      "body": "A concise section body."
    }
  ],
  "important_telegram_message_ids": ["604", "620"]
}

​
Notes

The period-summary prompt is separate from the source-summary prompt used by /v1/sources/by-ref. Period summaries can mention the selected period because they explicitly summarize a date range. Source summaries should not use period wording.