Skip to main content
POST
Chat with mailbox agent

Authorizations

x-api-key
string
header
required

API key (sk-proj-…) from Settings → API Keys. Required for sold API calls outside the Mermail console.

Body

application/json
mailboxId
string
required
conversationId
string
required
Example:

"conv_01"

messages
object[]
required

AI SDK UIMessage array (id, role, parts)

thread_id
string | null
trigger
enum<string>
Available options:
submit-message,
regenerate-message

Response

UI message stream

The response is of type string.