REST API v2

Every app action over HTTP, through the same safety gate as the app.

#Base URL

https://tlg.builera.app/api/public/v2

#Authentication

Every request carries the key of an AI connection (created in Settings → AI connections): Authorization: Bearer $TELEGRAM_AUTO_API_KEY. A connection has its own role, scopes, account list and budgets — never the full rights of the person who made it.

#Calling an operation

Each operation is POST /ops/<code> with a JSON body. Success answers { ok: true, data }; errors answer problem JSON (RFC 9457) with a code — see Error codes.

#Idempotency

Operations with effects need an Idempotency-Key header: the same key within 24 hours returns the first answer instead of acting twice. Retries after a network error always reuse the key.

#Actions the person must approve

Dangerous actions answer 409 confirmation_required with a summary and a confirm_token. The agent must show the summary to the person; only if they agree does it call again with the same input plus confirm_token.

#Work that runs on Telegram

Operations that "queue work for a node" return an operation_id; follow it with GET /operations/<id> or the operation.* events.

Full OpenAPI document (machine-readable): https://tlg.builera.app/api/public/v2/openapi.json

#All operations

293 operations, grouped by app area.

#Accounts

#Alerts

#Settings

#Alert bell

#Logs

#Automation

#Bots

#Inbox

#Campaigns

#People

#Discover

#Groups & channels

#Machines & proxies

#Account nurture

#Stats

#Manage channel

#Story viewer (marks as seen automatically)

#Story viewer