---
title: "Retrieve all of the custom tabs that would appear for the given role"
method: GET
path: "/v2/tab/summary/role/{roleId}"
tags: ["Custom Tabs"]
---

# Retrieve all of the custom tabs that would appear for the given role

`GET /v2/tab/summary/role/{roleId}`

## Request

- Base URL: `https://app.ninjarmm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ninjarmm.com/v2/tab/summary/role/{roleId}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sessionKey`
- TypeScript: <https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/docs/v2/tab/summary/role/:roleId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a summary of the tabs available to a given role

## Path parameters

- `roleId` integer, required

## Response `200`

Returns a list of the available custom tabs for the specified role, and the role hierarchy (used for sorting, if desired)

## Other responses

- `404`: The RoleId could not be found

## Changes

- **2025-12-12** `7c00bdd989ee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/changes/v2/tab/summary/role/:roleId/get.md)

---

[API](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0.md) - [All operations](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/revisions/5ce571d1bb71?raw)