---
title: "List Categories"
method: GET
path: "/api/v1/dashboards/dashboard-categories"
tags: ["dashboards"]
---

# List Categories

`GET /api/v1/dashboards/dashboard-categories`

List the tenant's tabs, system tabs first, then by sort order.

Nav display (default) shows ``everyone`` + granted tabs — the same set for
members and admins (admins auto-grant themselves on create). ``all_tabs``
is the admin-only "show all tabs" escape hatch (design §3: nav vs access are
separate concerns).

## Query parameters

- `all_tabs` boolean

## Response `200`

Successful Response

- DashboardCategoryRead[]
  - `id` string, uuid, required
  - `name` string, required
  - `slug` string, required
  - `icon` string, nullable
  - `page_heading` string, nullable
  - `description` string, nullable
  - `is_visible` boolean
  - `sort_order` integer, required
  - `is_system` boolean, required
  - `visibility` 'everyone' | 'granted_only', required — Who can see a DashboardCategory (tab). - ``everyone``: every tenant member sees the tab (the default for the system tabs we ship). - ``granted_only``: ADMINs + users listed in ``DashboardCategoryAccess``. The default for newly created tabs so a half-built tab never appears in the chairman's nav before an admin grants it. Named ``granted_only`` (not ``restricted``): it is never restricted *from* admins.
  - `created_by_user_id` string, uuid, nullable
  - `can_edit` boolean
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `domains` string[], required — The data domain(s) this tab exposes, from its slug. Drives which global filter dimensions the panel renders for the tab.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/c0f54348e251/schema)