# Roles

## List

`client.roles.list(RequestOptionsoptions?): RoleListResponse`

**get** `/roles`

Lists all roles for the workspace

### Returns

- `RoleListResponse`

  List of roles

  - `data: Array<Data>`

    - `id: string`

      Unique role ID

    - `role: string`

      Name of the role

### Example

```typescript
import Fragment from '@fragment-dev/ts-node';

const client = new Fragment();

const roles = await client.roles.list();

console.log(roles.data);
```

## Create

`client.roles.create(RoleCreateParamsbody, RequestOptionsoptions?): RoleCreateResponse`

**post** `/roles`

Creates a new role

### Parameters

- `body: RoleCreateParams`

  - `role: string`

    Name of the role

### Returns

- `RoleCreateResponse`

  - `data: Data`

    Role object

    - `id: string`

      Unique role ID

    - `role: string`

      Name of the role

### Example

```typescript
import Fragment from '@fragment-dev/ts-node';

const client = new Fragment();

const role = await client.roles.create({ role: 'admin' });

console.log(role.data);
```