---
title: "Set organization access permissions for a role"
method: PATCH
path: "/v2/user/role/{roleId}/permissions/organizations"
tags: ["management"]
---

# Set organization access permissions for a role

`PATCH /v2/user/role/{roleId}/permissions/organizations`

## 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/user/role/{roleId}/permissions/organizations`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sessionKey`
- TypeScript: <https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/docs/v2/user/role/:roleId/permissions/organizations/patch.ts> (a function with typed inputs; its response is checked against the schema)

Set up to 100 organization access permissions for a technician role

## Path parameters

- `roleId` integer, required

## Request body

- object[]
  - `organizationId` integer, required: Organization identifier
  - `permission` 'default' | 'noAccess' | 'view' | 'viewUpdate' | 'viewUpdateDelete', required: Permissions for the organization.

## Response `200`

Role organization permissions

- object
  - `id` integer
  - `name` string: Role name
  - `description` string: Role description
  - `organizationPermissions` object[]: Organization permissions updated for the provided role
    - `organizationId` integer: Organization identifier
    - `organizationName` string: Organization name
    - `permission` 'default' | 'noAccess' | 'view' | 'viewUpdate' | 'viewUpdateDelete': Permissions for the organization.

## Other responses

- `400`: Bad request or request limit reached
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Role or organization not found

## Changes

- **2026-07-26** `753f26d46650`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/changes/v2/user/role/:roleId/permissions/organizations/patch.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)