Message history is now deleted after your plan's retention window
Released: August 2, 2026
Message retention Changed
Section titled “Message retention ”Every plan has always advertised a history retention window —
quota.history_retention_days. It is now enforced. Messages older than
that window are permanently deleted, together with the inbound media
Kirimdev downloaded for them.
| Plan | History retained |
|---|---|
| Starter | 90 days |
| Pro | 365 days |
| Business | 365 days |
Read quota.history_retention_days rather than hard-coding a number; your
account may be on a custom value, and -1 means unlimited.
What this changes for integrations
Section titled “What this changes for integrations”GET endpoints that read message history return only what is still
stored. A range older than your window comes back empty or partial. That is
a successful response, not an error, and it is indistinguishable from a
period in which nothing was sent.
media_url on a deleted message stops resolving. If you rely on those
files, mirror them to your own storage.
Webhooks are unaffected — they fire when the event happens, long before any message approaches the window.
What is not deleted
Section titled “What is not deleted”Deletion is scoped to messages and does not cascade:
- Contacts and conversations remain intact. A conversation is one phone number and it stays in your inbox; only its old messages go.
- Media Library files keep their own lifecycle and storage quota. They are never removed by retention, even when a message that used them is.
- Broadcast campaigns and their per-recipient records are untouched.
Analytics survive
Section titled “Analytics survive”Aggregate metrics — volume, delivery funnel, per-template performance — stay available for periods whose messages have been deleted. Daily counters are captured before deletion so charts do not go blank as history ages out.
Response-time metrics are the exception: they pair two specific messages and cannot be rebuilt from counters, so they are reported only for the period still inside your window.
Read the full retention guide