doc return value of tag creation for API