# Users API

## Get users list [GET /v3/users]
> Get users list

### Request
  * Policy: read_users
  * Method: GET
  * Headers:
    -  Accept: application/json

### Response
**Status: 200**
  * Headers:
    -  Content-Type: application/json
  * Body:
```json
[
  {
    "id": "user id",
    "email": "user email",
    "roles": []
  }
]
```

## Create user [POST /v3/user]
> Create new user

### Request
  * Policy: create_users
  * Method: POST
  * Headers:
    -  Accept: application/json
    -  Content-Type: application/json
  * Body
```json
{
  "id": "user id",
  "password": "user password",
  "email": "user email",
  "roles": []
}
```

### Response
**Status: 201**
  * Headers:
    -  Content-Type: application/json
  * Body:
```json
{
  "id": "user id",
  "message": "Created"
}
```