Reference
Mark stories as seen
Tell Telegram the account viewed this person's stories up to `maxId` — the person sees the account among their viewers. Counts toward the 'View stories' daily limit.
View MarkdownThis page is generated from the source code on every release.
Tell Telegram the account viewed this person's stories up to maxId — the person sees the account among their viewers. Counts toward the 'View stories' daily limit.
Overview
| Name | Value |
|---|---|
| Code | stories.mark_seen |
| Scope needed | messages.send |
| Risk | Write |
| May need confirmation | No |
| Runs as | Queues work for a node |
Needs Idempotency-Key |
Yes |
| Member roles allowed | owner, manager, agent |
| Needs a worker from version | 1.0.29 |
| In the app | Story viewer (marks as seen automatically) |
Input fields
| Field | Type | Required | Description |
|---|---|---|---|
accountId |
uuid |
Yes | |
peer |
object |
Yes | |
maxId |
integer |
Yes |
Example request
curl -X POST https://tlg.builera.app/api/public/v2/ops/stories.mark_seen \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: <unique key per operation>" \
-d '{"accountId":"00000000-0000-0000-0000-000000000000","peer":"…","maxId":1}'Output fields (data)
| Field | Type | Required |
|---|---|---|
ok |
true |
Yes |
jobId |
text |
Yes |
Example answer
{
"data": {
"ok": true,
"jobId": "00000000-0000-4000-8000-000000000000"
}
}Using it over MCP
Not listed on any profile: call tools_describe then tools_run with code: "stories.mark_seen". Tool name when listed: stories_mark_seen.