Skip to main content
GET
Read the messages of a conversation your bot owns. Every message carries a seq number that only goes up, which makes it a safe bookmark for polling.

Authorization

string
required
Bearer mac_live_…

Path parameters

string
required
Must belong to the bot your key belongs to.

Query parameters

number
default:"0"
Return messages with a seq higher than this.
number
default:"50"
Between 1 and 100. Numbers outside that range are pulled back in.

Response

This endpoint returns the data directly, without an ok wrapper.
array
Oldest first.
number
The highest seq in the conversation right now. When it matches your bookmark, you are up to date.
To poll, remember the highest seq you have seen and send it back as after_seq.

Errors