# Update Role

Updates an existing role's properties including name, department, capacity, and utilization targets.

Endpoint: PATCH /v1/roles/{id}
Version: v1
Security: ApiKey

## Path parameters:

  - `id` (string, required)
    ID of the resource

## Request fields (application/json-patch+json):

  - `name` (string,null)
    The name of the Role, typically describing the job function or skill set (e.g. Designer, Developer).

  - `department_id` (string,null)
    The unique identifier of the Department that this Role belongs to for capacity and reporting segmentation.

  - `archived` (boolean,null)
    Indicates whether this Role has been archived and is no longer active for planning or reporting.

## Response 400 fields (application/json):

  - `type` (string)
    RFC reference for the error type

  - `title` (string)
    Human-readable summary of the error

  - `status` (integer)
    HTTP status code

  - `errors` (array)
    Detailed error messages for each validation failure

  - `trace_id` (string)
    Trace identifier for debugging


## Response 200 fields