Create a new role as a copy of an existing one.
The copy carries the role’s settings, its permissions, the sites, departments, asset categories, statuses and asset statuses it covers, and which fields it may edit or is kept from seeing. It does not carry where the role is named elsewhere — status moves, approval steps, workflows, work order types, subscriptions and shares — and it is held by nobody: assign people to it afterwards.
The name defaults to the original’s with “(copy)” after it, and the description to the original’s. The copy is always active. A copy of the System Administrator is an ordinary role holding today’s permissions; it does not receive permissions added by later releases.
Requires admin.role.create. Everything is copied in one transaction, so if any part is refused nothing is created. Where creating a role needs approval, the copy is refused; where only its permissions or grants do, those are counted as held rather than applied.
Returns the new role’s id and how many permissions, scope grants and field rules were copied.