# Roles

## List

**get** `/roles`

Lists all roles for the workspace

### Returns

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

  - `id: string`

    Unique role ID

  - `role: string`

    Name of the role

### Example

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

## Create

**post** `/roles`

Creates a new role

### Body Parameters

- `role: string`

  Name of the role

### Returns

- `data: object { id, role }`

  Role object

  - `id: string`

    Unique role ID

  - `role: string`

    Name of the role

### Example

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