---
descriptions:
  update_permission:
    name: The new name for the permission.
    description: >-
      The new description for the permission. Set to `null` to remove the
      description.
reference:
  curl:
    - key: update_permission
      id: update_permission
      url: /reference/roles/permission/update
      title: '/authorization/permissions/:slug'
      type: PATCH
      parameters:
        - key: name
          type: string
          optional: true
          description: (update_permission.name)
        - key: description
          type: string | null
          optional: true
          description: (update_permission.description)
      returns:
        - (permission)
  js:
    - key: updatePermission
      id: update_permission
      url: /reference/roles/permission/update
      title: authorization.updatePermission()
      parameters:
        - key: slug
          type: string
          description: The slug of the permission to update.
        - key: options
          type: object
          unwrap: true
          properties:
            - key: name
              type: string
              optional: true
              description: (update_permission.name)
            - key: description
              type: string | null
              optional: true
              description: (update_permission.description)
      returns:
        - key: Permission
          description: (permission.self)
  python:
    - key: update_permission
      id: update_permission
      url: /reference/roles/permission/update
      title: authorization.update_permission()
      parameters:
        - key: slug
          type: str
          description: The slug of the permission to update.
        - key: name
          type: str
          optional: true
          description: (update_permission.name)
        - key: description
          type: str | None
          optional: true
          description: (update_permission.description)
      returns:
        - key: Permission
          description: (permission.self)
originalPath: .tmp-workos-clone/packages/docs/content/reference/roles/permission/update.mdx
---

## Update a permission

Update an existing permission. Only the fields provided in the request body will be updated.

<CodeBlock referenceId="update_permission">
  <CodeBlockTab title="Request" file="update-permission-request" />
  <CodeBlockTab title="Response" file="update-permission-response" />
</CodeBlock>