# Users

## List

`users.list()  -> UserListResponse`

**get** `/users`

Lists all users for the workspace

### Returns

- `class UserListResponse: …`

  List of users

  - `data: List[Data]`

    - `id: str`

      Unique user ID

    - `external_id: str`

      External ID for the user

    - `role: str`

      Role of the user

### Example

```python
from fragment import Fragment

client = Fragment()
users = client.users.list()
print(users.data)
```

## Create

`users.create(UserCreateParams**kwargs)  -> UserCreateResponse`

**post** `/users`

Creates a new user

### Parameters

- `external_id: str`

  External ID for the user

- `role: str`

  Role of the user

### Returns

- `class UserCreateResponse: …`

  - `data: Data`

    User object

    - `id: str`

      Unique user ID

    - `external_id: str`

      External ID for the user

    - `role: str`

      Role of the user

### Example

```python
from fragment import Fragment

client = Fragment()
user = client.users.create(
    external_id="user_ext_123",
    role="admin",
)
print(user.data)
```