---
descriptions:
  add_role_permission:
    slug: The slug of the permission to add to the role.
reference:
  curl:
    - key: add_role_permission
      id: add_role_permission
      url: /reference/roles/role/add-permission
      title: '/authorization/roles/:slug/permissions'
      type: POST
      parameters:
        - key: slug
          type: string
          description: (add_role_permission.slug)
      returns:
        - (role)
  js:
    - key: addRolePermission
      id: add_role_permission
      url: /reference/roles/role/add-permission
      title: authorization.addRolePermission()
      parameters:
        - key: roleSlug
          type: string
          description: The slug of the role.
        - key: options
          type: object
          unwrap: true
          properties:
            - key: permissionSlug
              type: string
              description: (add_role_permission.slug)
      returns:
        - key: Role
          description: (role.self)
  python:
    - key: add_role_permission
      id: add_role_permission
      url: /reference/roles/role/add-permission
      title: authorization.add_role_permission()
      parameters:
        - key: slug
          type: str
          description: The slug of the role.
        - key: permission_slug
          type: str
          description: (add_role_permission.slug)
      returns:
        - key: Role
          description: (role.self)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/roles/role/add-permission.mdx
---

## Add a permission to an environment role

Add a single permission to an environment role. If the permission is already assigned to the role, this operation has no effect.

<CodeBlock referenceId="add_role_permission">
  <CodeBlockTab title="Request" file="add-role-permission-request" />
  <CodeBlockTab title="Response" file="add-role-permission-response" />
</CodeBlock>