Кратко

API черновиков — составляйте и ведите черновики до отправки: создавать, обновлять, планировать время отправки и отправлять, когда готово. Подходит агентам, которые собирают ответ по шагам, держат тред ответов или откладывают отправку.

Что нового

Новые endpoints:

  • GET /drafts — список черновиков (с фильтрами)
  • GET /drafts/{draft_id} — получить черновик
  • POST /inboxes/{inbox_id}/drafts — создать в ящике
  • PATCH /inboxes/{inbox_id}/drafts/{draft_id} — обновить
  • POST /inboxes/{inbox_id}/drafts/{draft_id}/send — отправить
  • DELETE /inboxes/{inbox_id}/drafts/{draft_id} — удалить

Возможности черновиков:

  • Поля to, cc, bcc, тема, текст и HTML
  • Тред через in_reply_to и references
  • Отложенная отправка через send_at
  • Вложения и метки
  • Список и фильтры по ящику, меткам, времени

Сценарии

Собирайте агентов, которые:

  • готовят многошаговые ответы перед отправкой
  • планируют фоллоу-апы
  • ставят исходящие в очередь и шлют пакетами
  • правят черновик по новому контексту
  • сохраняют корректные треды с in_reply_to
from agentinbox import Agentinbox
client = Agentinbox(api_key="your-api-key")
# create a draft in an inbox
draft = client.inboxes.drafts.create(
inbox_id="support@example.com",
to=["user@example.com"],
subject="Re: Your request",
text="We're looking into it.",
in_reply_to="<message-id@example.com>"
)
# update the draft
client.inboxes.drafts.update(
inbox_id="support@example.com",
draft_id=draft.draft_id,
text="We've resolved your request."
)
# send the draft
client.inboxes.drafts.send(
inbox_id="support@example.com",
draft_id=draft.draft_id
)

Подробнее — в разделе Черновики.