# Roles

A Role defines the type of work or skill set associated with resource assignments across projects and offerings. Roles are used to categorize resources, shape staffing needs, and support forecasting by identifying which types of personnel are required for each project or service offering.

## List Roles

 - [GET /v1/roles](https://developer.getparallax.com/api-documentation/swagger/roles/listroles.md): Returns paginated list of defined roles used in shaping resource plans, typically categorized by department and used to match people to work.

## Create Role

 - [POST /v1/roles](https://developer.getparallax.com/api-documentation/swagger/roles/createrole.md): Creates a new role within a department to be used for shaping, planning, and reporting.

## Get Role

 - [GET /v1/roles/{id}](https://developer.getparallax.com/api-documentation/swagger/roles/getrole.md): Gets details of a specific role used for shaping, planning, and reporting.

## Update Role

 - [PATCH /v1/roles/{id}](https://developer.getparallax.com/api-documentation/swagger/roles/updaterole.md): Updates an existing role's properties including name, department, capacity, and utilization targets.