Skip to content

Threads

Conversation groups built from Message-ID and In-Reply-To headers.

01

List threads#

Threads are ordered by the most recent message and include a message count and latest preview.

Shell
curl "https://botinbox.dev/v0/inboxes/INBOX_ID/threads?limit=25&q=research" -H "Authorization: Bearer $BOTINBOX_API_KEY"

02

Get a conversation#

Returns all messages in chronological order with attachment metadata.

Shell
curl https://botinbox.dev/v0/inboxes/INBOX_ID/threads/THREAD_ID -H "Authorization: Bearer $BOTINBOX_API_KEY"

03

Mark a thread read#

The read update applies to every inbound message in the thread.

Shell
curl https://botinbox.dev/v0/inboxes/INBOX_ID/threads/THREAD_ID \
  -X PATCH -H "Authorization: Bearer $BOTINBOX_API_KEY" -H "Content-Type: application/json" -d '{"read":true}'