---
title: "Set permissions on monitor or folder."
method: PUT
path: "/v1/monitors/permissions/set"
tags: ["monitorsLibraryManagement"]
---

# Set permissions on monitor or folder.

`PUT /v1/monitors/permissions/set`

Set permissions on monitor or folder in the monitors library.

## Request body

- PermissionStatementDefinitions
  - `permissionStatementDefinitions` PermissionStatementDefinition[], required — List of permission statement definitions.
    - `permissions` string[], required — List of permissions.
    - `subjectType` string, required — Type of subject for the permission. Valid values are: `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 `role`, subjectId should be the identifier of a role. Similarly, if the subjectType is `org`, the subjectId should be the identifier of the same org, which owns the resource target.
    - `targetId` string, required — The identifier that belongs to the resource this permission assignment applies to.

## Response `200`

List of the successfully set `PermissionStatements`.

- PermissionStatements
  - `permissionStatements` PermissionStatement[], required — A list of permission statements.
    - `permissions` string[], required — List of permissions.
    - `subjectType` string, required — Type of subject for the permission. Valid values are: `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 `role`, subjectId should be the identifier of a role. Similarly, if the subjectType is `org`, the subjectId should be the identifier of the same org, which owns the resource target.
    - `targetId` string, required — The identifier that belongs to the resource this permission assignment applies to.
    - `createdAt` string, date-time, required — Creation timestamp in UTC in [RFC3339](https://tools.ietf.org/html/rfc3339) format.
    - `createdBy` string, required — Identifier of the user who created the resource.
    - `modifiedAt` string, date-time, required — Last modification timestamp in UTC.
    - `modifiedBy` string, required — Identifier of the user who last modified the resource.

## 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/revisions/e4e4c7554890/schema)