WoyraDocs
Get an API key

A conversation

GET/v1/emails/threads/{id}

Emails · Requires an API key

Everything in one exchange, sent and received, oldest first. The id is the thread_id any email in it carries: the id of the email that started it. A reply to something you sent lands in that thread; a reply you send with in_reply_to joins it too. Requires emails:read.

Parameters

NameInDescription
idrequiredpath
Woyra-VersionheaderThe dated API version to serve. Omit to pin to the oldest supported version.

Example

curl https://api.woyra.io/v1/emails/threads/email_01J... \
  -H "Authorization: Bearer $WOYRA_KEY"

Response

200 The conversation.

FieldTypeDescription
object"thread"
idstringThe id of the email that started it.
subjectstring
messagesarray of object
messages.object"thread_item"
messages.directionstring
One of sent, received.
messages.attimestamp
messages.emailEmail
messages.receivedInboundEmailA message received on one of your domains.

Errors

StatusCodes
401authentication_required, invalid_api_key
403insufficient_scope, domain_not_verified, recipient_suppressed, sending_paused, mfa_required
404not_found, product_not_offered
451data_residency_violation

Also in Emails