Update Issue

PUT

/newsletters/{newsletter_id}/issues/{issue_id}

• Production
• QA

Update a draft issue in place. Only fields sent are changed. Rejects with 400 for issues no longer in a draft-editable state (mirrors the internal handler’s own ValueError -> 400 mapping).

Authorizations

• BearerAuth

Parameters

Path Parameters

newsletter_id

required

Newsletter UUID

string format: uuid

Newsletter UUID

issue_id

required

Issue id

integer

Issue id

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

Partial update for a draft issue. All fields optional — only the ones sent are changed (mirrors the internal exclude_unset=True handling in update_issue).

object

html_body

Any of:

string

string

null

null

plain_text

Any of:

string

string

null

null

preview_text

Any of:

string

string

<= 500 characters

null

null

reply_to

Any of:

string

string format: email

null

null

sender_email

Any of:

string

string format: email

null

null

sender_name

Any of:

string

string

<= 255 characters

null

null

subject

Any of:

string

string

<= 2000 characters

null

null

Responses

200

Successful Response

object

data

required

A single newsletter issue. Open dict — the internal handler returns the row dict plus derived KPI/status fields.

object

created_at

Any of:

string

string

null

null

id

Any of:

integer

integer

null

null

newsletter_id

Any of:

string

string

null

null

sent_at

Any of:

string

string

null

null

status

Any of:

string

string

null

null

subject

Any of:

string

string

null

null

updated_at

Any of:

string

string

null

null

key

additional properties

any

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string