Skip to main content

listRoles

client.swarm.listRoles(swarmId: string, params?: Record<string, unknown>): Promise<SwarmRole[]>

List roles in a swarm.

Retrieves all roles defined in a swarm, optionally filtered by query parameters. Use this to view available roles or populate role selection interfaces.

Parameters

ParameterTypeRequiredDescription
swarmIdstringYesThe unique identifier of the swarm
paramsRecord<string, unknown>NoOptional query parameters for filtering roles

Returns

Promise<SwarmRole[]> — A promise that resolves to an array of SwarmRole objects

Example

import { CodeBoltClient } from '@codebolt/clientsdk';

const client = new CodeBoltClient();

const result = await client.swarm.listRoles('swarmId');
console.log(result);