curator/curations.update
Updates a Curation in your Curator Media Unit
URL
POST /v1.0/curator/curations.update
Parameters
Argument | Required | Default Value | Example | Description |
---|---|---|---|---|
curation_id | Required | - | 12345678912345 | ID of the Curation. |
annotation | Optional | - | Why not go to the cherry blossoms | An annotation is the curator’s opinion, perspective, or impression of the content to be curated. |
status | Optional | - | Temporary | Describes a Curation’s status i.e. when it is set to “temporary” the curation is private, when it is set to “public”, the curation is public. |
published_at | Optional | Current date and time | 2015-10-10T04:50:40+00:00 | Describes the Story’s published date and time. Set the timestamp to a previous date to publish the Story immediately. To publish the Story at an impending date, set the timestamp to a future date. |
tag_ids | Optional | - | 90123459012345 | ID of tags. Use a comma separated list to indicate a collection of two or more selected tags. if the argument ‘s value is Null, tags will be omitted. |
Responses
{
"ok": true,
"curation": {
"id": "0123456",
"annotation": "Why not to go to see cherry blossoms?",
"status": "public",
"published_at": "2015-12-30T20:09:31+00:00",
"created_at": "2015-11-10T20:09:31+00:00",
"updated_at": "2015-12-25T18:58:10+00:00",
"content": {
"url": "https://nordot.app/0123456",
"url_curation": "https://nordot.app/0123456?c=0123456",
"title": "Counting down to sakura blooming",
"site_name": "The Nordot Post",
"description": "Norem ipsum dolor sit amet, consectetur adipisicing edit,
sed do eiusmod tempor incididunt ut labore rt dolore magna aliqua.
Ut enima ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut...",
"image_url": "https://img.nordot.jp/ch/images/0123456/origin_1.jpg",
"image_thumb_360": "https://img.nordot.jp/t_thumb_360/ch/images/0123456/origin_1.jpg",
"image_caption": "Ueno Onshi Park",
"published_at": "2015-12-10T20:09:31+00:00",
"expired_at": "2016-12-10T20:00:00+00:00",
"deleted": false,
},
"tags": [
"weather",
"weatherreport"
]
}
}
If successful, the updated data is returned. For more details, refer to the “curator curation” object section.
Errors
Error Code | Description |
---|---|
no_curation_id | Value for "curation_id" is not specified. |
invalid_curation_id | Value passed for “curation_id" is invalid. |
curation_not_found | The Curation cannot be found. |
no_update_param | Parameters could not be updated. |
invalid_content_url | Value passed for “content_url” is invalid. |
already_posted_content_url | Curation with identical “content_url” already exists. |
invalid_annotation | Value passed for “annotation” is invalid. |
invalid_status | Value passed for “status" is invalid. |
invalid_published_at | Value passed for “published_at” is invalid. |
invalid_tag_id | Value passed for “tag_id” is invalid. |
tag_not_found | The tag cannot be found. |
For other error codes, refer to the Common Errors section of this document.