- * @param type $title
- * @param type $description
- * @param type $tags comma separated tags
- * @param type $av_info a dictionary of video properties containing keys
- * width, height, dar (display aspect ratio), duration and size; is can be
- * returned with function get_av_info from video helper
+ * @param string $name
+ * @param string $title
+ * @param string $description
+ * @param string $tags comma separated tags
+ * @param string $duration video duration formatted [HH:]mm:ss
+ * @param array $formats a dictionary corresponding to `formats` JSON
+ * column from `videos` table
+ * @param int $category_id
+ * @param int $user_id
+ * @return mixed returns an activation code on success or FALSE otherwise