# Create a New Role

`POST /lokta-lms/api/v1/roles`

Mandatory Fields
name, description

## Request body (application/json)
- `description` (string)
- `name` (string)

## Responses
- `200`: OK

## Response fields
- `resourceId` (integer)

## Example request (cURL)
```bash
curl -X POST \
  'http://localhost:8080/lokta-lms/api/v1/roles' \
  -u '{username}:{password}' \
  -H 'Tenant-Identifier: default' \
  -H 'Content-Type: application/json' \
  -d '{
  "description": "A description outlining the purpose of this role in relation to the application.",
  "name": "Another Role Name"
}'
```

## Example response
```json
{
  "resourceId": 1
}
```

Interactive: https://developer.lokta.ai/reference.html#operation/createRole