Skip to content
Docs

Get Reply DraftBeta

Get the AI draft on a thread and what happened to it.

GET/api/v1/inbox/threads/{reply_id}/draft

Path Parameters#

reply_idstringpathrequired
The thread (reply) ID.

Response#

dataobject
Show Draft
idstring
Thread (reply) ID.
draftReplystring
Draft text.
draftReplyStatusstring
pending, completed, failed or regenerating.
draftReplyActionstring
null while awaiting a decision, otherwise sending, sent, dismissed or answered (the thread was replied to by hand).
draftReplyErrorstring
A short message when generation failed.
draftReplySentMessageIdstring
SMTP message ID once the draft was sent.
fromEmailstring
The lead who replied.
subjectstring
Subject of the reply.

Errors#

StatusDescription
404Thread not found

Rate Limit#

  • 300 requests per minute, shared by every read call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (read).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026