---
reference:
  curl:
    - key: delete_organization_role
      id: delete_organization_role
      url: /reference/roles/organization-role/delete
      title: '/authorization/organizations/:id/roles/:slug'
      type: DELETE
  js:
    - key: deleteOrganizationRole
      id: delete_organization_role
      url: /reference/roles/organization-role/delete
      title: authorization.deleteOrganizationRole()
      parameters:
        - key: organizationId
          type: string
          description: The ID of the organization.
        - key: slug
          type: string
          description: The slug of the role to delete.
  python:
    - key: delete_organization_role
      id: delete_organization_role
      url: /reference/roles/organization-role/delete
      title: authorization.delete_organization_role()
      parameters:
        - key: organization_id
          type: str
          description: The ID of the organization.
        - key: slug
          type: str
          description: The slug of the role to delete.
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/roles/organization-role/delete.mdx
---

## Delete an organization role

Delete an existing custom organization role. The role must not have any active assignments or [IdP group role mappings](/rbac/idp-role-assignment).

If the role has active assignments, you will receive a `409 Conflict` error with code `role_has_assignments`. If the role has group role mappings, you will receive a `409 Conflict` error with code `role_has_group_role_mappings`.

<CodeBlock
  title="Request"
  file="delete-organization-role-request"
  referenceId="delete_organization_role"
/>