updateOrgRole
Updates a role's name, description, and/or permission set. Requires the 'manage_members' permission on the role's org (super admins bypass). If input.permissions is provided it replaces the entire set (empty array clears all); omit to leave permissions unchanged. Throws FORBIDDEN when input.permissions is given for a SYSTEM role (such as the org's built-in 'admin'): system roles have a fixed permission set, so create a custom role and assign that instead. Name and description remain editable on a system role.
updateOrgRole(
orgRoleId: BigInt!
input: UpdateOrgRoleInput!
idempotencyKey: String
): OrgRole!
Arguments
updateOrgRole.orgRoleId ● BigInt! non-null scalar
Role id (org_role_id as a BigInt string).
updateOrgRole.input ● UpdateOrgRoleInput! non-null input
updateOrgRole.idempotencyKey ● String scalar
Optional idempotency key. Recommended for retries: replaying with the same key and identical arguments returns the first result instead of re-applying; the same key with different arguments returns IDEMPOTENCY_CONFLICT. Keys expire after 24h.