# Users

## List

**get** `/users`

Lists all users for the workspace

### Returns

- `data: array of object { id, externalId, role }`

  - `id: string`

    Unique user ID

  - `externalId: string`

    External ID for the user

  - `role: string`

    Role of the user

### Example

```http
curl https://api.us-west-2.fragment.dev/users
```

## Create

**post** `/users`

Creates a new user

### Body Parameters

- `externalId: string`

  External ID for the user

- `role: string`

  Role of the user

### Returns

- `data: object { id, externalId, role }`

  User object

  - `id: string`

    Unique user ID

  - `externalId: string`

    External ID for the user

  - `role: string`

    Role of the user

### Example

```http
curl https://api.us-west-2.fragment.dev/users \
    -H 'Content-Type: application/json' \
    -d '{
          "externalId": "user_ext_123",
          "role": "admin"
        }'
```