Create Tag¶
Create a new tag that can later be used for tagging files and folders.
Note: can only be called by admins of can organisation
Request¶
POST https://test-uni.cloudplan.biz/api/search/create_tag
{
"tag_string": "" //the display name of the tag
"display_type": "" //(optional - default: "single") type of the tag:
single/date/integer/select/bool/string/timestamp/float
"parent_id": "" //(optional - default: "") tag id of this tags parent
"selections": ["", ""] //(optional - default: []) a list of strings
"format": "" //(optional) helper value for displaying
"unit": "" //(optional) helper value for displaying
"val_int_default": 0 //(optional) default integer value for the tag
"val_str_default": "" //(optional) default string value for the tag
"val_float_default": 0.0 //(optional) default float value for the tag
"protected": true/false //(optoinal) set deletion protection for the tag
}
Note: use these types when setting values for tags with display types in /search/add_tag
single: -
date: val_int
integer: val_int
select: val_str
bool: val_int
string: val_str
timestamp: val_int
float: val_float
Reply¶
{
"result": true/false
"reason": ...
"tag_id": ...
}
Error Codes¶
user_not_admin
no_tag_string
bad_tag_type
tag_alread_exists
db_insert_failed
bad_display_type
parent_not_found
too_deep_hierarchy