Skip to content
Docs

Dismiss Reply DraftBeta

Mark the draft as not wanted so it leaves the drafts list. Sends nothing.

POST/api/v1/inbox/threads/{reply_id}/draft/dismiss

Path Parameters#

reply_idstringpathrequired
The thread (reply) ID.

Dismissing an already dismissed draft succeeds. Regenerate brings a new one.

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
403Key does not have write scope
404Thread not found
409The draft was already sent, answered, or has no ready draft

Rate Limit#

  • 120 requests per minute, shared by every write 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 (write).
  • 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