Update a curation's tags

POST

/api/v3/curations/{uniqueId}/tags

const url = 'https://api.tryletterhead.com/api/v3/curations/example/tags?api=true';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"tags":["coffee","agriculture"]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

Replace a curation’s tags without touching its content or any other field. Pass an empty array to clear all tags. Returns a 404 if no curation with this uniqueId belongs to the company.

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

application/json

object

tags

Array<string>

Example

{
  "tags": [
    "coffee",
    "agriculture"
  ]
}

Responses

202

Tags updated

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",
    "tags": [
      "coffee",
      "agriculture"
    ]
  },
  "message": "Tags updated successfully.",
  "total": 1
}

404

No curation with this uniqueId belongs to the company

Still can’t find what you need? Contact support.