List categories
Tool ID: kocodesk_categories_list
Summary
List the system categories on your site, either as a nested tree or a flat lookup list.
When to use it
- Before tagging a blog post, to find the right category ids.
- When you want to see how your category tree is organised.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| KocoDesk credentials | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
root_id |
No | Only show categories under this one. Use the blog category root to get blog categories only. |
flat |
No | true returns a simple list instead of a nested tree. |
language |
No | Language to read titles in (default is the primary language). |
What you get back
Categories with their id, title and slug. Nested by default, so you can see parents and children.
Example prompts
Show me the categories on my site.
List the blog categories so I can pick one for a new post.
Give me a flat list of every category with its id.
Tips
- Blog posts are tagged with category ids, so look them up here first.
- Ask for the blog settings first — the blog category root narrows this list to just blog categories.
- This tool is read-only; category editing still happens in the KocoDesk admin.