riddle_tag_list

com.riddle/creator · Verify this server

Lists the tags of a project together with how many Riddles use each of them: [{id, name, count}]. Tags are per project - a tag of one project cannot be applied to a Riddle of another - so pass the projectId of the project whose Riddles you are tagging; omitting it returns the tags of the project the API key is scoped to (your personal tags for a user API key). Use this to find the tag "id" values riddle_list/riddle_account_list accept in their "tags" filter, and to check whether a tag already exists before riddle_tag_add creates a new one. "count" counts RIDDLES only, and Riddle tags and question bank tags are ONE set per project (the same tag can be applied to both and has the same id in either): a tag with "count": 0 therefore means "no Riddle uses this tag", not "nothing uses it" - question banks may well be using it, see questionBank_tagList. A tag is deleted automatically as soon as neither a Riddle nor a bank uses it any more - by untagging its last carrier, and by deleting that carrier - so a tag listed here is either in use somewhere or a leftover from before that cleanup existed, which riddle_tag_delete removes.