Drafts

Approve and send a draft

Needs an admin key, so an agent can't approve its own mail. Members can also approve in the dashboard. A draft someone else already decided returns 409.

post/v1/drafts/{draft_id}/send

Request

  • Base URL: https://api.send0.dev
  • URL: https://api.send0.dev/v1/drafts/{draft_id}/send
  • Auth: HTTP bearer

Path parameters

draft_idstring required

Draft id (drf_…)

Headers

Idempotency-Keystring

Retry-safe POSTs: same key + same body returns the stored response for 24 hours.

Response

Message

object'message' required
idstring required
inbox_idstring required
thread_idstring required
direction'in' | 'out' required
status'received' | 'queued' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' required
expiredboolean required

true once the inbox's retention period has passed: text, html, extracted_text, extracted and attachments are gone (null or empty) and the raw message can't be downloaded. Addresses, subject, status and timestamps remain until the message is deleted, 35 days after it was created.

rfc_message_idstring nullable required
in_reply_tostring[] required
referencesstring[] required
subjectstring required
textstring nullable required
htmlstring nullable

Only on single-message reads and threads with include_html=true

extracted_textstring nullable required

New text only: quoted history, forwards and signatures removed

tagstring nullable required

Plus-address tag, e.g. task42 for bot+task42@

sizeinteger required
sent_atstring date-time nullable required
received_atstring date-time nullable required
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.