Docs

PATCH /topics/{id}

Rename a topic or change its default. Changing the default never rewrites an answer a contact already gave.

Parameters

  • id path · string · required
  • Idempotency-Key header · string · optional — Makes 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
default_subscribedbooleanno
descriptionstring | nullno
namestringno

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
created_atstringyes
default_subscribedbooleanyes
descriptionstring | nullyes
idstringyes
namestringyes
updated_atstringyes

Errors

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

PreviousGET /topics/{id}NextDELETE /topics/{id}