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://this.kiji.is/0123456",
            "url_curation": "https://this.kiji.is/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": [
            {
                "id": "9012345",
                "name": "Hanami"
            }
        ]
    }
}

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.