SDK
SDK Javascript v7.x
2

mDeleteRoles #

Deletes multiple security roles.

Throws a partial error (error code 206) if one or more role deletions fail.


mDeleteRoles(ids, [options]);

PropertyTypeDescription
ids
array<string>
Role identifiers
options
object
Query options

options #

PropertyType
(default)
Description
queuable
boolean

(true)
If true, queues the request during downtime, until connected to Kuzzle again
refresh
boolean

(false)
If set to wait_for, Kuzzle will not respond until the roles deletion is indexed
timeout
number

(-1)
Time (in ms) during which a request will still be waited to be resolved. Set it -1 if you want to wait indefinitely
triggerEvents
boolean

(false)
If set to true, will trigger events even if using Embeded SDK. You should always ensure that your events/pipes does not create an infinite loop.
Available since Kuzzle 2.31.0

Resolves #

An array of the deleted roles ids.

Usage #

try {
  const response = await kuzzle.security.mDeleteRoles([
    'role1',
    'role2',
    'role3',
    'role4',
    'role5'
  ]);
  console.log(response);
  /*
  [ 'role1', 'role2', 'role3', 'role4', 'role5' ]
    */
} catch (e) {
  console.error(e);
}