bldinit Telegram Rest API

The telegram-rest API from bldinit — 8 operation(s) for telegram-rest.

GitHub OpenAPI

Operations 8

POST /api/v1/telegram/sendMessage 메시지 발송 (★ irreversible) #
POST /api/v1/telegram/sendPhoto 사진 발송 (★ irreversible) #
POST /api/v1/telegram/sendDocument 파일 발송 (★ irreversible) #
POST /api/v1/telegram/editMessageText 메시지 텍스트 수정 #
POST /api/v1/telegram/deleteMessage 메시지 삭제 (★ irreversible) #
GET /api/v1/telegram/getMe Bot 정보 #
GET /api/v1/telegram/getUpdates 새 메시지 polling (webhook 미설정 시) #
POST /api/v1/telegram/answerCallbackQuery Inline button 응답 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-telegram-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-telegram-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Telegram Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: telegram-rest
paths:
  /api/v1/telegram/sendMessage:
    post:
      tags:
      - telegram-rest
      summary: 메시지 발송 (★ irreversible)
      description: '``chat_id`` 으로 메시지 발송. parse_mode (Markdown / HTML) 지원.

        ``reply_markup`` 으로 inline keyboard / reply keyboard 부착 가능.


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**: 수신자 단말 알림 도달,

        mcpweave 측 회수 불가. ``telegram_delete_message`` 로 메시지 자체 삭제

        가능하지만 알림은 회수 불가.


        Native pass-through.'
      operationId: telegram_send_message
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/telegram/sendPhoto:
    post:
      tags:
      - telegram-rest
      summary: 사진 발송 (★ irreversible)
      description: '``chat_id`` 으로 사진 발송. ``photo`` = URL (Telegram 이 fetch) 또는

        Telegram file_id (이미 업로드된 파일 재사용). multipart upload 는

        Phase 2 trigger.


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**: 수신자 단말 도달.


        Native pass-through.'
      operationId: telegram_send_photo
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/telegram/sendDocument:
    post:
      tags:
      - telegram-rest
      summary: 파일 발송 (★ irreversible)
      description: '``chat_id`` 으로 일반 파일 (PDF / zip / docx 등) 발송. ``document`` =

        URL 또는 file_id. 50MB max (URL) / 20MB max (file_id reuse).


        **URL 발송 시 Telegram 은 binary mime 만 accept** — text/plain (.txt 등)

        / HTML 은 "web page" 로 해석해 거절 (``Bad Request: wrong type of the

        web page content``). PDF / zip / docx / image 등은 OK.


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**.


        Native pass-through.'
      operationId: telegram_send_document
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/telegram/editMessageText:
    post:
      tags:
      - telegram-rest
      summary: 메시지 텍스트 수정
      description: 'bot 이 발송한 메시지의 텍스트 수정. ``chat_id`` + ``message_id`` 또는

        inline mode 의 ``inline_message_id``.


        Recoverable — 다시 edit 으로 이전 텍스트 복원 가능. irreversible 아님.


        Native pass-through.'
      operationId: telegram_edit_message
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/telegram/deleteMessage:
    post:
      tags:
      - telegram-rest
      summary: 메시지 삭제 (★ irreversible)
      description: 'bot 이 발송한 메시지 (또는 group/supergroup 에서 admin 권한 가진 채널의

        다른 메시지) 삭제. **48시간 이내** 만 삭제 가능 (Telegram 측 제약).


        **Irreversible (ADR-028/030 Cat B — 영구 삭제)**: API 삭제 후 복구 불가.


        Native pass-through.'
      operationId: telegram_delete_message
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/telegram/getMe:
    get:
      tags:
      - telegram-rest
      summary: Bot 정보
      description: 현재 bot 의 metadata (id / username / first_name / can_join_groups 등). Native pass-through.
      operationId: telegram_get_me
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/telegram/getUpdates:
    get:
      tags:
      - telegram-rest
      summary: 새 메시지 polling (webhook 미설정 시)
      description: 'Long polling 방식으로 새 메시지 / event 받기. ``offset`` (마지막 받은

        update_id + 1) / ``timeout`` (long poll 초) / ``limit``.


        **주의**: ``setWebhook`` 활성 시 사용 불가 (HTTP 409 conflict).

        Phase 1 default = polling. Phase 2 SNS-Webhook sprint 시 setWebhook

        흐름 추가.


        Native pass-through.'
      operationId: telegram_get_updates
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: offset
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Offset
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Limit
      - name: timeout
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Timeout
      - name: allowed_updates
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Allowed Updates
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/telegram/answerCallbackQuery:
    post:
      tags:
      - telegram-rest
      summary: Inline button 응답
      description: 'Inline keyboard button 클릭 시 발생한 ``callback_query`` 에 응답. 사용자에게

        toast / alert 표시 또는 답장. 응답 안 하면 Telegram client 가 spinner

        표시.


        Recoverable — 응답 자체는 일시적 UI 알림 (메시지 X). irreversible 아님.


        Native pass-through.'
      operationId: telegram_answer_callback_query
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)