Skip to content

Get Admin Menu (GraphQL)

Returns the admin sidebar as a nested tree, filtered to what the authenticated token's role is allowed to see. Use it to build a back-office navigation/sidebar dynamically and to discover which API operation backs each screen.

Output Fields

FieldTypeDescription
idstringIdentifier of the menu payload (menu).
treeJSONThe nested menu structure.

tree is returned as a JSON structure — query it as a bare field, not a sub-selection.

Each node in tree (and in any nested children) carries key, label, icon, sort, permission, apiResource, and children. When present, apiResource maps the node to its backing endpoint as { rest, graphql }; it is null for group headers (parent menus that only contain children) and for panel-only screens that have no API counterpart.

Permission Filtering

The tree is scoped to the token's role:

  • A token whose permission type is all sees every menu node.
  • A token with custom permissions sees only the nodes its role permits; menus it cannot access are omitted entirely.

So two admins with different roles will receive different trees from the same operation.

All admin operations require an admin Bearer token — see Authentication.

Released under the MIT License.