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

## Set permissions for an environment role

Replace all permissions assigned to an environment 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_role_permissions">
  <CodeBlockTab title="Request" file="set-role-permissions-request" />
  <CodeBlockTab title="Response" file="set-role-permissions-response" />
</CodeBlock>