Skip to main content
Version: V2 (Ignition 8.1)

deleteRoles

Overview​

Deletes multiple roles with the specified IDs and returns a JSON response indicating success or failure.

Permissions​

This method requires the SYSTEM.ADMIN permission.

Parameters​

ParameterTypeNullableDescription
idsList<String>FalseThe list of unique identifiers of the roles to delete.

Returns​

If successful, an ApiResponse object is returned with the success flag set to true. If unsuccessful, an IllegalArgumentException or ConstraintViolationException is thrown. If the shift being deleted has references, an ApiResponse object is returned with details about the error.

NameTypeDescription
successBooleanIndicates if the delete was successful.
messageStringThe reason why the deletion was successful or unsuccessful.
dataStringThe data associated with the deletion.
errorStringThe errors associated with the deletion.

Example​

response = system.mes.role.deleteRoles(["01JAP8RJBN-8ZTPXSGY-J9GSDPE1", "01JAP8R5RT-3FPXQABY-7KQZT6VF"])