h1./admin/role
h2. GET /admin/role
Get all roles
{panel}{{GET /rest/admin/role}}{panel}


h3. Sample
*Request:*
{code}GET /rest/admin/role{code}

*Response:*
{code}TODO: Sample Response{code}


h2. GET /admin/role/\{role\}
Get role by its name
{panel}{{GET /rest/admin/role/*\{role\}*}}{panel}

* *Parameters:*
|| Name || Type || Description ||
| role | string | TODO: Description |


h3. Sample
*Request:*
{code}GET /rest/admin/role/TODO{code}

*Response:*
{code}TODO: Sample Response{code}


h2. PUT /admin/role/\{role\}
Add a new role 
{panel}{{PUT /rest/admin/role/*\{role\}*?*\{description\}*}}{panel}

* *Parameters:*
|| Name || Type || Description ||
| role | string | TODO: Description |
| description | string | TODO: Description |


h3. Sample
*Request:*
{code}PUT /rest/admin/role/TODO?description=TODO{code}

*Response:*
{code}TODO: Sample Response{code}


h2. POST /admin/role/\{role\}
Update a new role 
{panel}{{POST /rest/admin/role/*\{role\}*?*\{newName\}*&*\{description\}*}}{panel}

* *Parameters:*
|| Name || Type || Description ||
| role | string | TODO: Description |
| newName | string | TODO: Description |
| description | string | TODO: Description |


h3. Sample
*Request:*
{code}POST /rest/admin/role/TODO?newName=TODO&description=TODO{code}

*Response:*
{code}TODO: Sample Response{code}


h2. GET /admin/role/\{role\}/permission
Get role permissions
{panel}{{GET /rest/admin/role/*\{role\}*/permission}}{panel}

* *Parameters:*
|| Name || Type || Description ||
| role | string | TODO: Description |


h3. Sample
*Request:*
{code}GET /rest/admin/role/TODO/permission{code}

*Response:*
{code}TODO: Sample Response{code}


h2. POST /admin/role/\{role\}/permission/\{permission\}
Add specified permission to role
{panel}{{POST /rest/admin/role/*\{role\}*/permission/*\{permission\}*}}{panel}

* *Parameters:*
|| Name || Type || Description ||
| role | string | TODO: Description |
| permission | string | TODO: Description |


h3. Sample
*Request:*
{code}POST /rest/admin/role/TODO/permission/TODO{code}

*Response:*
{code}TODO: Sample Response{code}


h2. DELETE /admin/role/\{role\}/permission/\{permission\}
Delete specified permission to role
{panel}{{DELETE /rest/admin/role/*\{role\}*/permission/*\{permission\}*}}{panel}

* *Parameters:*
|| Name || Type || Description ||
| role | string | TODO: Description |
| permission | string | TODO: Description |


h3. Sample
*Request:*
{code}DELETE /rest/admin/role/TODO/permission/TODO{code}

*Response:*
{code}TODO: Sample Response{code}



