IMessages

v1 stable

/api/bot/IMessages/v1/

Send messages and retrieve message history from channels.

f67be823cf6cb77a… SHA-256 contract hash — guaranteed stable

Authentication required

All endpoints require Authorization: Bot <token> header. Get a token →

GET /api/bot/IMessages/v1/History ReadMessages

Gets message history for a channel. Pass channelId as a query parameter. Supports pagination via from (message ID) and limit (1–100, default 50).

Response MessageHistoryResponse

Field Type
messages MessageDto[]
↳ channelId string
↳ createdAt string
↳ creatorId string
↳ entities IMessageEntity[]
↳ unionIndex uint32
↳ unionKey string
↳ messageId int64
↳ replyTo int64 | null
↳ spaceId string
↳ text string

Errors

Status Code Description
403 not_a_member Bot is not a member of this space.

Example

$ curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://api.argon.gl/api/bot/IMessages/v1/History
POST /api/bot/IMessages/v1/Send SendMessages

Sends a text message to a channel. Include a unique randomId for deduplication. Optionally reply to another message via replyTo.

Request Body SendMessageRequest

Field Type
channelId string
entities IMessageEntity[]
↳ unionIndex uint32
↳ unionKey string
randomId int64
replyTo int64 | null
text string

Response SendMessageResponse

Field Type
messageId int64

Errors

Status Code Description
403 not_a_member Bot is not a member of this space.

Example

$ curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"channelId":"...","entities":[],"randomId":"0","replyTo":null,"text":"..."}' \
     https://api.argon.gl/api/bot/IMessages/v1/Send