Update curation

POST

/api/v2/channels/{{channel}}/aggregates/{curationUuid}

Create or update a content aggregate

This endpoint allows you to update a curation for a specific channel.

Authorizations

• bearerAuth

Parameters

Path Parameters

channel

required

string

curationUuid

required

string

Request Body

Media type multipart/form-data

object

api

required | When true, instructs the endpoint that you’re authenticating with an organization key as opposed to some other method. In almost all cases you will want to set this value to true.

string

Example

true

content

optional | html content for the curation, only p and formatting elements are allowed.

string

Example

<p>I have been <b>curated</b>.</p>

excerpt

optional | Plain text excerpt of the curated content. Will overwrite what we fetch from the URL.

string

Example

The excerpt is often mapped with an RSS feed's description node - but not always.

image

optional | The URL of a featured image to associate with this piece of content.

string

Example

https://letterhead.ai/hubfs/Letterhead_CTA9_July2023/images/footer_logo.svg

publicationDate

optional | The Y-m-d H:i:s formatted date of publication.

string

Example

2024-02-05 00:00:00

siteName

optional | The name of the site the curated content originated from.

string

Example

Black Bitter Coffee

tags[]

optional | string[] | An optional array of string tags with which to associate this piece of content. Example: ['dogs', 'canines']

string

Example

delightfully-caffeinated

title

optional | Title of the curated content.

string

Example

Is this the tastiest coffee ever?

url

required | URL to the content you would like Letterhead to crawl. We will fetch what we can glean from the site’s Open Graph.

string

Example

https://example.org

Responses

202

Update curation

Media type application/json

object

items

object

archived

boolean

content

string

createdAt

string

curated

boolean

dateOfAggregatePublication

string

excerpt

string

feedUniqueId

string

image

string

originalUrl

string

publicationDate

string

siteName

string

tags

Array<string>

title

string

uniqueId

string

updatedAt

string

message

string

total

number

Examples

Example Update curation

{
  "items": {
    "archived": false,
    "content": "<p>I have been <b>curated</b>.</p>",
    "createdAt": "2025-01-07 00:01:12",
    "curated": false,
    "dateOfAggregatePublication": "2025-02-05 16:51:20",
    "excerpt": "The excerpt is often mapped with an RSS feed's description node - but not always.",
    "feedUniqueId": "",
    "image": "https://letterhead.ai/hubfs/Letterhead_CTA9_July2023/images/footer_logo.svg",
    "originalUrl": "https://css-tricks.com/how-to-make-a-folder-slit-effect-with-css/",
    "publicationDate": "2024-02-05 00:00:00",
    "siteName": "Black Bitter Coffee",
    "tags": [
      "delightfully-caffeinated"
    ],
    "title": "Is this the tastiest coffee ever?",
    "uniqueId": "b8ee3a270d8615d23bf17335b2986bc3",
    "updatedAt": "2025-01-07 00:01:12"
  },
  "message": "Your curation was successfully updated.",
  "total": 1
}

Headers

Access-Control-Allow-Credentials

string

Example

true

Access-Control-Allow-Origin

string

Example

*

Access-Control-Max-Age

string

Example

86400

Cache-Control

string

Example

no-cache, private

Connection

string

Example

keep-alive

Date

string

Example

Wed, 05 Feb 2025 16:51:20 GMT

Server

string

Example

nginx/1.14.0 (Ubuntu)

Transfer-Encoding

string

Example

chunked