curator/tags.create

Creates a tag in your Curator Media Unit

URL

POST /v1.0/curator/tags.create

Parameters

Argument Required Default Value Example Description
unit_id Required - 12345678912345 ID of the tag.
name Required - Hanami Name of the tag.

Responses

{
    "ok": true,
    "tag": {
        "id": "9012345",
        "name": "Hanami",
        "created_at": "2015-11-10T20:09:31+00:00",
        "updated_at": "2015-11-10T20:09:31+00:00"
    }
}

If successful, the method returns generated data. For more details, please refer to the “curator tag” object.

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 The Media Unit cannot be found.
no_name Value for “name” is not specified.
invalid_name Value passed for “name" is invalid.
name_taken Tag name taken.
too_many_tags Number of tags exceeds specified limit.

For other error codes, refer to the Common Errors section of this document.