Toggle a curation's curated status

POST

/api/v3/curations/toggle/{uniqueId}

curl --request POST \
  --url 'https://api.tryletterhead.com/api/v3/curations/toggle/example?api=true' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "curated": true }'

• Production

Mark a curation as curated (ready to use in a newsletter) or not, without changing anything else about it.

Authorizations

• bearerAuth

Parameters

Path Parameters

uniqueId

required

string

The curation’s unique identifier, from List curations or Curate or update content.

Query Parameters

api

required

boolean

Required. Set to true to authenticate with your company API key rather than a signed-in session.

Request Body ^required

Media type application/json

object

curated

boolean

Example

{
  "curated": true
}

Responses

200

Curated status updated.

Media type application/json

object

items

The shape a curation is returned in after Toggle a curation’s curated status, Update a curation, or Update a curation’s tags — a lighter shape than the one List curations returns, without internal identifiers.

object

uniqueId

string

title

string

excerpt

string

content

string

author

string

siteName

string

originalUrl

string

image

string

imageAlt

string

imageCaption

string

publicationDate

string

dateOfAggregatePublication

string

curated

boolean

archived

boolean

archiveDate

string

nullable

useBy

string

nullable

feedUniqueId

string

nullable

type

Content type — 0 articles, 1 events, 2 AI-generated, 3 WordPress, 4 RSS, 5 browser extension, 6 Zapier, 7 JSON data feed.

integer

createdAt

string

updatedAt

string

deletedAt

string

nullable

tags

Array<string>

customFields

Present only when the curation has at least one custom field value set, keyed by the custom field’s key (see List curation custom fields).

object

message

string

total

integer

Example

{
  "items": {
    "uniqueId": "cur_8x2mle4kq9",
    "title": "How coffee prices are shaping this year's harvest",
    "curated": true,
    "publicationDate": "2026-08-30 09:00:00",
    "updatedAt": "2026-09-01T08:00:00+00:00"
  },
  "message": "Article status updated.",
  "total": 1
}