Curate in bulk
const url = 'https://api.tryletterhead.com/api/v3/curations/bulk';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"api":true,"curations":[{"url":"https://example.com/article-one","title":"First Article","channels":["an-example-channel"]},{"url":"https://example.com/article-two","title":"Second Article","excerpt":"A brief summary of the second article.","tags":["politics","local"],"overwriteTags":true},{"url":"https://example.com/article-three","channels":["an-example-channel"]}]}'};
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/bulk \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "api": true, "curations": [ { "url": "https://example.com/article-one", "title": "First Article", "channels": [ "an-example-channel" ] }, { "url": "https://example.com/article-two", "title": "Second Article", "excerpt": "A brief summary of the second article.", "tags": [ "politics", "local" ], "overwriteTags": true }, { "url": "https://example.com/article-three", "channels": [ "an-example-channel" ] } ] }'Create multiple curations for any channel within the company. Note that the v3 api requires a key generated from within the company-level settings.
Unlike the single Curate or update content endpoint, channels here creates a separate curation per channel: list two channels and you get two curations, one on each, matched and updated independently by its own url (together with its type and, if it came from a feed, the feed it came from). Omit channels on a curation and it’s created once as a single company-level curation instead, shared with every channel — the way the single endpoint’s omitted channels works.
It accepts the same parameters as the Curate endpoint.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
Required. Set to true to authenticate with an API key.
object
Optional — list one or more channels to create a separate curation on each. Omit to create a single curation shared with every channel in the company instead.
Example
{ "api": true, "curations": [ { "url": "https://example.com/article-one", "title": "First Article", "channels": [ "an-example-channel" ] }, { "url": "https://example.com/article-two", "title": "Second Article", "excerpt": "A brief summary of the second article.", "tags": [ "politics", "local" ], "overwriteTags": true }, { "url": "https://example.com/article-three", "channels": [ "an-example-channel" ] } ]}Responses
Section titled “ Responses ”202 Accepted
object
Example
{ "message": "3 curations accepted for processing", "status": 202, "total": 4}Still can’t find what you need? Contact support.