# Users

## List

`client.users.list(RequestOptionsoptions?): UserListResponse`

**get** `/users`

Lists all users for the workspace

### Returns

- `UserListResponse`

  List of users

  - `data: Array<Data>`

    - `id: string`

      Unique user ID

    - `externalId: string`

      External ID for the user

    - `role: string`

      Role of the user

### Example

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

const client = new Fragment();

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

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

## Create

`client.users.create(UserCreateParamsbody, RequestOptionsoptions?): UserCreateResponse`

**post** `/users`

Creates a new user

### Parameters

- `body: UserCreateParams`

  - `externalId: string`

    External ID for the user

  - `role: string`

    Role of the user

### Returns

- `UserCreateResponse`

  - `data: Data`

    User object

    - `id: string`

      Unique user ID

    - `externalId: string`

      External ID for the user

    - `role: string`

      Role of the user

### Example

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

const client = new Fragment();

const user = await client.users.create({ externalId: 'user_ext_123', role: 'admin' });

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