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.