# Update a job title

Updates the fields supplied and returns the role in the same shape as reading it.
Only the fields sent are touched, so an empty body is a valid request that changes
nothing, and omitting `training_ids` leaves the assigned training alone rather than
clearing it.
The role stays under the functional area it was created in; this endpoint does not
move it.

Endpoint: PUT /api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}
Version: 2.0.0
Security: default

## Path parameters:

  - `functionalarea_id` (integer, required)
    The ID of the functional area.

  - `id` (integer, required)
    The ID of the job title.

## Header parameters:

  - `Rosterfy-Platform` (string)

## Request fields (application/json):

  - `name` (string)
    The name administrators see. Required.

  - `frontend_name` (string)
    The name volunteers see in the portal. Required, and shown in place of `name` to anyone without administrator access, so it is worth setting even when the two match.

  - `code` (string)
    A short reference for the role, unique across the account rather than just within the group. Letters, numbers, dashes and underscores only - spaces and punctuation are rejected. Stored and returned in upper case whatever case it is sent in.

  - `description` (string)
    What the role involves, as HTML. Shown to volunteers alongside the role. Sanitised on the way out, so unsupported markup will not be returned as sent.

  - `training_ids` (array)
    The IDs of the training modules assigned to anyone who takes on this role. **Replaces the whole list** rather than adding to it, so send every module you want kept. Omitting the field leaves the stored list untouched.

## Response 200 fields (application/json):

  - `object` (object)

  - `object.id` (integer)

  - `object.headcount_functional_area_id` (integer)

  - `object.name` (string)

  - `object.frontend_name` (string)

  - `object.code` (string)

  - `object.description` (string)

  - `object.training_ids` (array)

  - `object.deleted_at` (string | null)

  - `object.created_at` (string)

  - `object.updated_at` (string)

  - `object.uuid` (string)

  - `nice` (object)

  - `nice.rrn` (string)

  - `nice.functional_area_name` (string)

  - `relations` (object)

  - `relations.functional_area` (object)

  - `relations.functional_area.object` (object)

  - `relations.functional_area.object.id` (integer)

  - `relations.functional_area.object.account_id` (integer)

  - `relations.functional_area.object.headcount_functional_area_type_id` (integer)

  - `relations.functional_area.object.name` (string)

  - `relations.functional_area.object.frontend_name` (string)

  - `relations.functional_area.object.code` (string)

  - `relations.functional_area.object.target` (integer)

  - `relations.functional_area.object.auto_update_mode` (integer)

  - `relations.functional_area.object.rules` (array)

  - `relations.functional_area.object.training_ids` (array)

  - `relations.functional_area.object.is_system` (integer)

  - `relations.functional_area.object.deleted_at` (string | null)

  - `relations.functional_area.object.created_at` (string)

  - `relations.functional_area.object.updated_at` (string)

  - `relations.functional_area.object.updated_by` (integer)

  - `relations.functional_area.object.uuid` (string)

  - `relations.functional_area.nice` (object)

  - `relations.functional_area.nice.rrn` (string)

  - `permissions` (object)

  - `permissions.read` (boolean)

  - `permissions.update` (boolean)

  - `permissions.delete` (boolean)