A Telegram group's announced window
The group's window: its settings (Synq's defaults for one never saved), its state, the topics Synq has seen, every reminder with when it goes, and the counts: verified, still to verify, and unknown to Synq, with the deadline's pacing. Needs `org.integrations.view`.
/v1/orgs/{org}/telegram-groups/{group}/windowThe group's window: its settings (Synq's defaults for one never saved), its state, the topics Synq has seen, every reminder with when it goes, and the counts: verified, still to verify, and unknown to Synq, with the deadline's pacing. Needs org.integrations.view.
Authorization
bearer An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.
In: header
Path Parameters
The org's id
^org_[0-9a-hjkmnp-tv-z]{26}$The Telegram group's id
^tgg_[0-9a-hjkmnp-tv-z]{26}$Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/telegram-groups/tgg_01h455vb4pex5vsknk084sn02q/window" \ -H "Authorization: Bearer $SYNQ_API_KEY"{ "group": "string", "state": "draft", "notice_days": 0, "deadline_time": "string", "time_zone": "string", "quiet_hours": { "from": "22:00", "to": "09:00" }, "name_unverified": true, "message_reachable": true, "headline": "string", "topic": 0, "forum": true, "on_lost": "mute", "topics": [ { "id": 0, "name": "Acme", "closed": true } ], "starts_at": "2026-10-21T12:00:00.000Z", "ends_at": "2026-10-21T12:00:00.000Z", "paused_at": "2026-10-21T12:00:00.000Z", "extended_at": "2026-10-21T12:00:00.000Z", "members_listed_at": "2026-10-21T12:00:00.000Z", "members_list_complete": true, "closed_at": "2026-10-21T12:00:00.000Z", "schedule": [ { "reminder": "m1", "kind": "monthly", "at": "2026-10-21T12:00:00.000Z", "message_reachable": true, "names": true, "done": true } ], "counts": { "members": 0, "admins": 0, "verified": 0, "to_verify": 0, "unknown": 0, "settled": 0 }, "deadline": { "per_minute": 0, "minutes": 0 }, "problem": "members_unknown", "problem_detail": "string", "announce_queued_at": "2026-10-21T12:00:00.000Z", "announce_failure": "string", "move": { "from_topic": 0, "requested_at": "2026-10-21T12:00:00.000Z", "waits_until": "2026-10-21T12:00:00.000Z" }}Disconnect a Telegram group DELETE
Takes the bot out of the group and stops the org's gate there, from now on: whoever is in it stays, a muted person stays muted until an admin lifts it, and join requests wait for the group's other admins. Needs `org.integrations.edit`. Recorded as `telegram_group.disconnected`.
Read a connected Telegram group GET
Needs `org.integrations.view`.