GET
/
api
/
v1
/
email
/
{email_id}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

email_id
string
required

Response

200 - application/json
bcc_addresses
object[]
required
cc_addresses
object[]
required
date
string
required
from_address
object
required
id
string
required
in_reply_to_id
string | null
required

The id of the email that this email is a reply to, as passed in the In-Reply-To header. If null, this email is not a reply to another email

inbox_id
string
required
message_id
string | null
required

The message id of the email, as passed in the Message-ID header. This is not the same as the BotMailRoom email id but rather is an id used by email clients and servers to identify emails

prompt
string
required

The email formatted as markdown that can be passed into an LLM prompt

references
string[] | null
required

A list of ids of emails that precede this email in a conversation thread, as passed in the References header. If null, this email is not part of a conversation thread

reply_to_addresses
object[]
required
subject
string
required
thread_prompt
string
required

The entire email thread formatted as markdown that can be passed into an LLM prompt. If the email is not part of a thread or is not the root email, this will be the same as the prompt property

to_addresses
object[]
required
alternative_content
boolean
default:
false

If true, html and plain_text are alternative representations of the same content

attachments
object[]

Metadata about the attachments of the email, does not include the actual attachment data. Use the relevant get attachment endpoints to retrieve the attachment data

html
string | null

The html content of the email. Can be null if the email is only available in plain text

plain_text
string | null

The plain text content of the email. Can be null if the email is only available in html

previous_emails
object[] | null

A list of emails that precede the root email in a conversation thread, as passed in the References header. If an email is not part of a conversation thread or is not the root email, this field will be null