---
descriptions:
  set_organization_role_permissions:
    permissions: >-
      An array of permission slugs to assign to the role. This replaces all
      existing permissions.
reference:
  curl:
    - key: set_organization_role_permissions
      id: set_organization_role_permissions
      url: /reference/roles/organization-role/set-permissions
      title: '/authorization/organizations/:id/roles/:slug/permissions'
      type: PUT
      parameters:
        - key: permissions
          type: 'string[]'
          description: (set_organization_role_permissions.permissions)
      returns:
        - (organization_role)
  js:
    - key: setOrganizationRolePermissions
      id: set_organization_role_permissions
      url: /reference/roles/organization-role/set-permissions
      title: authorization.setOrganizationRolePermissions()
      parameters:
        - key: organizationId
          type: string
          description: The ID of the organization.
        - key: roleSlug
          type: string
          description: The slug of the role.
        - key: options
          type: object
          unwrap: true
          properties:
            - key: permissions
              type: 'string[]'
              description: (set_organization_role_permissions.permissions)
      returns:
        - key: OrganizationRole
          description: (organization_role.self)
  python:
    - key: set_organization_role_permissions
      id: set_organization_role_permissions
      url: /reference/roles/organization-role/set-permissions
      title: authorization.set_organization_role_permissions()
      parameters:
        - key: organization_id
          type: str
          description: The ID of the organization.
        - key: slug
          type: str
          description: The slug of the role.
        - key: permissions
          type: 'list[str]'
          description: (set_organization_role_permissions.permissions)
      returns:
        - key: OrganizationRole
          description: (organization_role.self)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/roles/organization-role/set-permissions.mdx
---

## Set permissions for an organization role

Replace all permissions assigned to an organization role. This operation removes any existing permissions and assigns the provided permissions.

To remove all permissions from a role, pass an empty array.

<CodeBlock referenceId="set_organization_role_permissions">
  <CodeBlockTab
    title="Request"
    file="set-organization-role-permissions-request"
  />
  <CodeBlockTab
    title="Response"
    file="set-organization-role-permissions-response"
  />
</CodeBlock>