Skip to content

IMessages

v1 stable

/IMessages/v1/

Send messages and retrieve message history from channels.

bd1b0ab376c3db85… SHA-256 contract hash — guaranteed stable

Authentication required

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

GET /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
↳ controls ControlRowV1[]
↳ controls BotControlV1[]
↳ colour OklchColor
↳ c float
↳ h float
↳ l float
↳ customId string
↳ disabled boolean | null
↳ id string
↳ label string
↳ labelLocalizations Dictionary`2
↳ maxValues int32 | null
↳ minValues int32 | null
↳ options SelectOptionV1[]
↳ default boolean | null
↳ description string
↳ label string
↳ value string
↳ placeholder string
↳ requiredArchetypeId string | null
↳ type "button" | "stringSelect" | "userSelect" | "archetypeSelect" | "channelSelect"
↳ url string
↳ variant "callback" | "link" | null
↳ createdAt string
↳ creatorId string
↳ entities IMessageEntity[]
↳ messageId int64
↳ reactions ReactionDto[]
↳ count int32
↳ emoji string
↳ userIds string[]
↳ 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://gateway.argon.zone/IMessages/v1/History
POST /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
controls ControlRowV1[]
↳ controls BotControlV1[]
↳ colour OklchColor
↳ c float
↳ h float
↳ l float
↳ customId string
↳ disabled boolean | null
↳ id string
↳ label string
↳ labelLocalizations Dictionary`2
↳ maxValues int32 | null
↳ minValues int32 | null
↳ options SelectOptionV1[]
↳ default boolean | null
↳ description string
↳ label string
↳ value string
↳ placeholder string
↳ requiredArchetypeId string | null
↳ type "button" | "stringSelect" | "userSelect" | "archetypeSelect" | "channelSelect"
↳ url string
↳ variant "callback" | "link" | null
entities IMessageEntity[]
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":"...","controls":[],"entities":[],"randomId":"0","replyTo":null,"text":"..."}' \
     https://gateway.argon.zone/IMessages/v1/Send