Docs

PATCH /broadcasts/{id}

Edit a DRAFT — or rename ANY broadcast. Sent content is immutable.

Parameters

  • id path · string · required
  • Idempotency-Key header · string · optionalMakes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request).

Request body

FieldTypeRequiredNotes
contentobjectno
namestringno
scheduled_atstringno
segment_idstringno
subjectstringno

Responses

  • 200 Success
  • 400 Validation error
  • 401 Missing API key
  • 403 Forbidden
  • 404 Not found
  • 409 Conflict
  • 429 Rate limited
  • 500 Internal server error

Response headers

  • ratelimit-limit — Messages this API key may spend in one 60-second window.
  • ratelimit-remaining — Messages left in the current window.
  • ratelimit-reset — Seconds until the current window resets and the budget refills.

200 body

FieldTypeRequiredNotes
archived_atstring | nullyes
contentobject | nullyes
created_atstringyes
from_addressstring | nullyes
idstringyes
namestringyes
scheduled_atstring | nullyes
segment_idstring | nullyes
sent_atstring | nullyes
sent_countintegeryes
statusstringyes
subjectstring | nullyes
template_idstring | nullyes
updated_atstringyes

Errors

Codes in the catalogue that answer with one of this operation’s error statuses. Every one of them carries a fix.