---
title: "Add permissions to a content item."
method: PUT
path: "/v2/content/{id}/permissions/add"
tags: ["contentPermissions"]
---

# Add permissions to a content item.

`PUT /v2/content/{id}/permissions/add`

Add permissions to a content item with the given identifier.

## Path parameters

- `id` string, required

## Headers

- `isAdminMode` string

## Request body

- ContentPermissionUpdateRequest
  - `contentPermissionAssignments` ContentPermissionAssignment[], required — Content permissions to be updated.
    - `permissionName` string, required — Content permission name. Valid values are: `View`, `GrantView`, `Edit`, `GrantEdit`, `Manage`, and `GrantManage`.
    - `sourceType` string, required — Type of source for the permission. Valid values are: `user`, `role`, and `org`.
    - `sourceId` string, required — An identifier that belongs to the source type chosen above. For e.g. if the sourceType is set to "user", sourceId should be identifier of a user (same goes for `role` and `org` sourceType)
    - `contentId` string, required — Unique identifier for the content item.
  - `notifyRecipients` boolean, required — Set this to "true" to notify the users who had a permission update.
  - `notificationMessage` string, required — The notification message sent to the users who had a permission update.

## Response `200`

Updated permission object for the requested content item.

- ContentPermissionResult
  - `explicitPermissions` ContentPermissionAssignment[], required — Explicitly assigned content permissions.
    - `permissionName` string, required — Content permission name. Valid values are: `View`, `GrantView`, `Edit`, `GrantEdit`, `Manage`, and `GrantManage`.
    - `sourceType` string, required — Type of source for the permission. Valid values are: `user`, `role`, and `org`.
    - `sourceId` string, required — An identifier that belongs to the source type chosen above. For e.g. if the sourceType is set to "user", sourceId should be identifier of a user (same goes for `role` and `org` sourceType)
    - `contentId` string, required — Unique identifier for the content item.
  - `implicitPermissions` ContentPermissionAssignment[] — Implicitly inherited content permissions.
    - `permissionName` string, required — Content permission name. Valid values are: `View`, `GrantView`, `Edit`, `GrantEdit`, `Manage`, and `GrantManage`.
    - `sourceType` string, required — Type of source for the permission. Valid values are: `user`, `role`, and `org`.
    - `sourceId` string, required — An identifier that belongs to the source type chosen above. For e.g. if the sourceType is set to "user", sourceId should be identifier of a user (same goes for `role` and `org` sourceType)
    - `contentId` string, required — Unique identifier for the content item.

## 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/18a824df1e78/schema)