# Update a Job

Updates the job's own details: name, dates, notes, external link and custom field values. It does not touch the job's inventory.
- Any nullable field you omit or send as null is cleared, so fetch the job first and
  send it back with your changes.
- Custom field values are the exception: the ones you send are set, and the rest keep
  their value. A job holds up to 2.
- To add items to the job, use Pull Items into Job. To change status, use the
  status endpoint.

Endpoint: PUT /api/v1/jobs/{job_id}
Security: BearerAuth

## Path parameters:

  - `job_id` (number, required)
    ID of the job
    Example: "101"

## Request fields (application/json):

  - `name` (string, required)
    Name of the job. Must be unique within the company. Max 190 characters.

  - `notes` (string)
    Job notes. Omit or send null to clear. Max 4000 characters.

  - `start_date` (string)
    Date the job starts, as YYYY-MM-DD. Omit or send null to clear.

  - `end_date` (string)
    Date the job is expected to be finished by, as YYYY-MM-DD. Omit or send null to clear.

  - `external_job_link` (string)
    Link to this job in an external system. Omit or send null to clear.

  - `custom_field_values` (array, required)
    Sets the values it carries. A job holds at most 2. Send value null to clear one field. Fields left out keep their current value, so an empty array changes nothing.

  - `custom_field_values.custom_field_id` (number, required)
    ID of the job custom field.

  - `custom_field_values.value` (string)
    The value to store. Max 191 characters.

  - `custom_field_values.version` (number)
    Version of the stored value, from the last read of the job.

  - `version` (number, required)
    The version returned by the last read of this job. A stale version is rejected with 409.

## Response 200 fields (application/json):

  - `data` (object)

  - `data.id` (number)

  - `data.name` (string)

  - `data.status` (string)

  - `data.folder_id` (number)

  - `data.custom_field_values` (array)

  - `data.custom_field_values.custom_field_id` (number)

  - `data.custom_field_values.value` (string,null)

  - `data.custom_field_values.version` (number,null)

  - `data.created_by` (object)

  - `data.updated_by` (object)

  - `data.created_at` (string)

  - `data.updated_at` (string)

  - `data.start_date` (string,null)

  - `data.end_date` (string,null)

  - `data.notes` (string,null)

  - `data.external_job_link` (string,null)

  - `data.started_at` (string,null)

  - `data.completed_at` (string,null)

## Response 400 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 401 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 403 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 404 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 409 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 429 fields (application/json):

  - `message` (string)