curator/curations.create

Creates a Curation in your Curator Media Unit

URL

POST /v1.0/curator/curations.create

Parameters

Argument Required Default Value Example Description
unit_id Required - 12345678912345 ID of your Curator Media Unit.
content_url Required Null https://this.kiji.is/1234567 URL of a Story to be curated.
annotation Optional Null 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 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 in the future, set the timestamp to a forthcoming date.
tag_ids Optional Null 90123459011345 ID of tags. Use a comma separated list to indicate a collection of two or more selected tags. if 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": "draft",
                "published_at": "2018-03-05T02:51:20+00:00",
                "created_at": "2018-03-05T02:51:21+00:00",
                "updated_at": "2018-03-05T02:51:21+00:00",
                "content":{
                "url": "http://this.kiji.is/0123456",
                "url_curation": "http://this.kiji.is/0123456",
                "title": "this.kiji.is",
                "site_name": "",
                "description": "",
                "image_url": "",
                "image_url_w": 0,
                "image_url_h": 0,
                "image_thumb_360": "",
                "image_caption": "",
                "published_at": "",
                "expired_at": "",
                "deleted": false,
                "unit": null
            },
            "tags":[
                {
                    "id": "1122333",
                    "name": "Hanami",
                    "created_at": "2016-04-27T05:10:35+00:00",
                    "updated_at": "2016-04-27T05:10:35+00:00"
                }
            ],
            "unit":{
                "id": "0001234",
                "name": "NST",
                "path": "ndt",
                "status": "public",
                "signature_color": "FFD900",
                "header_type": "border",
                "header_position": "left",
                "profile_name": "ndt!",
                "introduction": "My favorite only...",
                "created_at": "2015-11-17T11:13:45+00:00",
                "updated_at": "2018-02-28T14:42:24+00:00",
                "header_image": null,
                "profile_image":{
                "url": "https://nordot-res.cloudinary.com/cu/units/0001234/profile_6.png",
                "thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/cu/units/0001234/profile_6.png"
            },
            "follow":{
              "twitter_url": "",
              "facebook_page_url": ""
            },
            "connection":{
              "facebook": false,
              "twitter": false
            },
            "publisher":{
                "id": "0012345",
                "name": "Nordot Inc.",
                "created_at": "2015-11-16T19:02:38+00:00",
                "updated_at": "2018-02-06T17:29:41+00:00"
            },
            "language": "en-US",
            "timezone": "America/Indiana/Indianapolis",
              "website_urls":["https://www.0012345.jp/"],
              "facebook_url": "https://www.facebook.com/0012345",
              "twitter_url": "https://twitter.com/0012345",
              "instagram_url": "https://instagram.com/0012345"
            }
        }
    }
}

If successful, the generated data is returned. For more details, refer to the “curator curation” object section.

Errors

Error Code Description
no_unit_id Value for "unit_id" is not specified.
invalid_unit_id Value passed for “unit_id" is invalid.
unit_not_found Media Unit cannot be found.
no_content_url Value for Content URL is not specified.
invalid_content_url Value passed for “content_url” is invalid.
already_posted_content_url Curation with matching “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.