---
title: "List permission summaries for a monitor or folder."
method: GET
path: "/v1/monitors/{id}/permissionSummariesBySubjects"
tags: ["monitorsLibraryManagement"]
---

# List permission summaries for a monitor or folder.

`GET /v1/monitors/{id}/permissionSummariesBySubjects`

List permission summary meta(s) grouped by subjects on monitor or folder in the monitors library.

## Path parameters

- `id` string, required

## Response `200`

The list of permission summary meta(s) grouped by subjects for the monitor or folder.

- PermissionSummariesBySubjects
  - `permissionSummariesBySubjects` PermissionSummaryBySubjects[], required — A list of PermissionSubjects and PermissionSummaryMeta(s) associated with each subject.
    - `subjectType` string, required — Type of subject for the permission. Valid values are: `user` or `role` or `org`.
    - `subjectId` string, required — The identifier that belongs to the subject type chosen above. For e.g. if the subjectType is set to `user`, subjectId should be the identifier of a user (same goes for `role` or `org` subjectType).
    - `permissionSummaries` PermissionSummaryMeta[], required
      - `name` string, required — Name of the permission. Example values are: `Read`, `Update`, `Create`, etc.
      - `isInherited` boolean, required — A true value implies that the permission is inherited from some ancestors of the resource. A false value implies that the permission is explicitly assigned to the resource.
      - `isExplicit` boolean, required — A true value implies that the permission is explicitly assigned to the resource. A false value implies that the permission is not explicitly assigned to the resource.
      - `isRevoked` boolean, required — A true value implies that the capability required for this permission has been revoked.
      - `isRecursive` boolean, required — A true value implies that the permission is recursively cascaded down to all the direct and indirect children of the resource.
      - `isSystemDefined` boolean, required — A true value implies that the permission is defined by the system on the resource and can not be modified by the user. A false value implies that the permission is defined by the user on the resource and can be modified by the user.

## Other responses

- `default` — Operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/versions/18a824df1e78/schema)