Insights · Developer account

getBotUpdates

Read the updates queued for a bot

This method authenticates with your developer account. The easiest way to call it is the dashboard, which signs the request for you. Direct calls need a dashboard session cookie.

Owner-scoped raw update rows for one env, newest first. Payload is the same object the bot would receive via webhook/getUpdates.

Request

curl https://api.sprintelex.com/getBotUpdates \
  # authenticated with your dashboard session \
  -H "Content-Type: application/json" \
  -d '{"bot_id":"<bot-id>"}'

Parameters

Name	Type	Required	Rules
bot_id	string	Yes	-
env	string	No (default 'live')	free-form string; filtered by equality against the env column
limit	integer	No (default 50)	clamped to 1-200

Response

{ ok: true, result: { updates: [ { update_id, type, payload, webhook_attempts, delivered_webhook, created_at } ] } }

Rate limit: none in code

Errors

Status	Error	When
400	bot_id is required	missing bot_id
404	bot not found	no such bot, not owned by caller, or deleted
500	could not load updates	DB query failed