Sign in

v51

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-01121113461.4 KB
threads

Retrieve a single thread, ignoring spam/trashed filters.

Deep-link sharing relies on a stable URL that survives state changes: a shared link must keep working after the thread is archived, marked as spam, or moved to trash. The ThreadAccess permission check still applies, so unauthorized users get 404.

get/api/v1.0/threads/{id}/

Path parameters

idstring required

Response

idstring uuid required

primary key for the record as UUID

subjectstring nullable required
snippetstring required
messagesstring required
has_unreadboolean required
has_unread_mentionboolean required
has_trashedboolean required
is_trashedboolean required

Whether all messages in the thread are trashed

has_archivedboolean required
has_draftboolean required
has_starredboolean required
has_attachmentsboolean required
has_senderboolean required
has_messagesboolean required
has_delivery_failedboolean required

True if thread has messages with permanent delivery failure.

has_delivery_pendingboolean required

True if thread has messages awaiting successful delivery (sending, retrying, or failed).

is_spamboolean required
has_activeboolean required
messaged_atstring date-time nullable required
active_messaged_atstring date-time nullable required

Date of the last active (received, not spam/archived/trashed/draft) message.

draft_messaged_atstring date-time nullable required

Date of the last draft (non-trashed) message.

sender_messaged_atstring date-time nullable required

Date of the last sent (non-trashed, non-draft) message.

archived_messaged_atstring date-time nullable required

Date of the last archived (non-trashed) message.

trashed_messaged_atstring date-time nullable required

Date of the last trashed message.

sender_namesstring[] required
updated_atstring date-time required

date and time at which a record was last updated

user_role'viewer' | 'editor' required
summarystring required
events_countinteger required
abilitiesobject required