Skip to main content
POST
Snooze or unsnooze a thread

Authorizations

Authorization
string
header
required

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

Path Parameters

thread_id
string<uuid>
required

Body

application/json

INB-12: when to resurface the thread; null cancels the snooze.

snoozed_until
string<date-time> | null
required

Response

Successful Response

channel
enum<string>
required

Which surface a conversation happens on.

Threads are contact-scoped, not channel-scoped, so this says how a thread is REACHED rather than partitioning the inbox: a reply arrives, is classified and stops the cadence identically either way, and only the send path differs.

Available options:
email,
linkedin
contact_email
string | null
required
contact_key
string
required
contact_name
string
required
created_at
string<date-time>
required
id
string<uuid>
required
is_bounce
boolean
required
is_out_of_office
boolean
required
is_unread
boolean
required
label_ids
string<uuid>[]
required
last_message_at
string<date-time>
required
last_snippet
string
required
mailbox_id
string<uuid> | null
required
message_count
integer
required
sequence_id
string<uuid> | null
required
step_id
string<uuid> | null
required
subject
string
required
updated_at
string<date-time>
required
can_reply_on_linkedin
boolean
default:false

INB-09: whether an explicit channel='linkedin' reply can go out on this thread — it carries a LinkedIn member identity and a paired account. The composer's channel toggle keys off this.

contact_linkedin_url
string | null

INB-08: the contact's LinkedIn profile URL, when our own evidence (invitation ledger, dispatched actions, or the sequence's mapped column) names one. Only the SINGLE-thread read resolves it; the list leaves it null.

enrolment_id
string<uuid> | null

§79: the contact's enrolment in this thread's sequence, when it has one — the id the 'Resume cadence' action targets.

has_pending_draft
boolean
default:false

INB-04: an AI reply is waiting for approval on this thread — the list row's 'Action required' mark. Only the thread LIST populates it; single-thread reads leave it False and the open conversation fetches the draft itself.

match_excerpt
string | null

§63: the matched message, headlined around the match. Only set when searching.

snoozed_until
string<date-time> | null

INB-12: hidden from the working views until this instant.

stop_reason
enum<string> | null

§79: set when the cadence is stopped (reply, unsubscribe, bounce, ...). None for a live or normally-completed enrolment. Only 'reply' is resumable.

Available options:
reply,
unsubscribe,
bounce,
manual,
company_reply,
row_left_audience,
step_removed,
removed