Bot API

Bot API Docs

Public reference for owner-side management and bot-token runtime endpoints.

All endpointsOwnerBot runtimeWebhooksLong pollingTS SDKOpenAPI JSONRedocSwagger UI
List bot channels
Bot tokenGET/v1/bot-api/channels

Lists channels available to the current bot token.

Authorization: Bearer bot token

Status codes
200Lists channels available to the current bot token.
401Missing or invalid bearer token.
429Rate limit exceeded.
curl
curl -H "Authorization: Bearer <bot_token>" https://api.yullama.ru/v1/bot-api/channels
JSON response
{
  "items": [
    {
      "bot_role": "moderator",
      "created_at": "2026-04-21T10:00:00Z",
      "description": "Owned channel for bot publishing",
      "id": "22d6...",
      "slug": "news-russia",
      "title": "News Russia"
    }
  ]
}
Create channel post
Bot tokenPOST/v1/bot-api/channels/{id}/posts

Publishes a post as the bot into an attached channel.

Authorization: Bearer bot token

Parameters
idpath · requiredAttached channel identifier.
Status codes
201Publishes a post as the bot into an attached channel.
400Malformed input or invalid parameter value.
401Missing or invalid bearer token.
403Authenticated but not allowed to perform this action.
429Rate limit exceeded.
curl
curl -X POST https://api.yullama.ru/v1/bot-api/channels/<channel_id>/posts \
  -H "Authorization: Bearer <bot_token>" \
  -H "Content-Type: application/json" \
  -d '{"body":"Bot API production news update"}'
JSON request
{
  "body": "Bot API production news update"
}
JSON response
{
  "author_username": "newsbot_russia_v1",
  "body": "Bot API production news update",
  "channel_id": "22d6...",
  "created_at": "2026-04-21T10:55:00Z",
  "id": "90ab..."
}
Get current bot
Bot tokenGET/v1/bot-api/me

Returns bot identity for the current bot token.

Authorization: Bearer bot token

Status codes
200Returns bot identity for the current bot token.
401Missing or invalid bearer token.
429Rate limit exceeded.
curl
curl -H "Authorization: Bearer <bot_token>" https://api.yullama.ru/v1/bot-api/me
JSON response
{
  "bot_user_id": "b63c...",
  "display_name": "News Bot Russia",
  "id": "7f9d...",
  "username": "newsbot_russia_v1"
}
Poll updates
Bot tokenGET/v1/bot-api/updates

Consumes bot events using offset/limit/timeout semantics.

Authorization: Bearer bot token

Parameters
offsetquery · optionalReturn updates with `update_id > offset`.
limitquery · optionalMaximum number of items to return.
timeoutquery · optionalLong polling timeout in seconds. Current maximum is 30 seconds.
Status codes
200Consumes bot events using offset/limit/timeout semantics.
400Malformed input or invalid parameter value.
401Missing or invalid bearer token.
429Rate limit exceeded.
curl
curl -H "Authorization: Bearer <bot_token>" "https://api.yullama.ru/v1/bot-api/updates?offset=0&limit=50&timeout=30"
JSON response
{
  "items": [
    {
      "created_at": "2026-04-21T10:42:00Z",
      "event_type": "channel.post_created",
      "payload": {
        "body": "Owner published to channel",
        "channel_id": "22d6...",
        "post_id": "90ab..."
      },
      "update_id": 41
    }
  ]
}