Curate in bulk

POST

/api/v3/curations/bulk

Create multiple curations for any channel within the company. Note that the v3 api requires a key generated from within the company-level settings.

Provided that you are curating the same url, Letterhead will not create a duplicate curation, and you can use this endpoint to also update one if it is already in the system.

It accepts the same parameters as the Curate endpoint.

Authorizations

• bearerAuth

Request Body

Media type application/json

object

curations

Array<object>

object

channels

Array<string>

excerpt

string

overwriteTags

boolean

tags

Array<string>

title

string

url

string

Examples

Example Curate in bulk

{
  "curations": [
    {
      "channels": [
        "news",
        "tech"
      ],
      "title": "First Article",
      "url": "https://example.com/article-one"
    },
    {
      "excerpt": "A brief summary of the second article.",
      "overwriteTags": true,
      "tags": [
        "politics",
        "local"
      ],
      "title": "Second Article",
      "url": "https://example.com/article-two"
    },
    {
      "channels": [
        "sports"
      ],
      "url": "https://example.com/article-three"
    }
  ]
}

Responses

202

202 Accepted

Media type application/json

object

message

string

status

number

total

number

Examples

Example 202 Accepted

{
  "message": "3 curations accepted for processing",
  "status": 202,
  "total": 4
}