Messages

Send uploaded Telegram media

Sends one or more previously uploaded media payloads into the selected chat.

post/v1/chats/{chat_id}/messages/media

Request

  • Base URL: https://api.entergram.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.entergram.com/v1/chats/{chat_id}/messages/media
  • Auth: API key in header X-API-Key

Path parameters

chat_idstring required

Canonical Telegram chat identifier.

Example:-1000001234567

Request body

accountIdstring required

Connected account id from the accounts endpoint.

idempotencyKeystring required

Client-supplied idempotency key used to identify retries.

parseModestring

Optional Telegram parse mode for the caption.

replyToMessageIdinteger

Optional Telegram message id to reply to.

textstring

Optional caption text for the upload batch.

uploadIdsstring[] nullable required

Previously uploaded media payload ids to send.

Example request

{
  "accountId": "acct_demo_123",
  "idempotencyKey": "media-2026-04-16-001",
  "parseMode": "Markdown",
  "replyToMessageId": 123450,
  "text": "Please review the attached file.",
  "uploadIds": [
    "9f3b2ab4-1a2b-4b8e-8d12-4d9d2a31c8f8"
  ]
}

Response

Created

Changes

No recorded changes to this operation across all 1 revision of this API.