---
title: "Update a Job"
method: PATCH
path: "/api/v1/jobs/{job_id}"
---

# Update a Job

`PATCH /api/v1/jobs/{job_id}`

Update supported metadata fields on an existing Hover job

## Path parameters

- `job_id` string, required

## Request body

- object
  - `job` object
    - `name` string — A name for this job.
    - `location_line_1` string — First line of this job's address.
    - `location_line_2` string — Second line of this job's address.
    - `location_city` string — The city of this job's address.
    - `location_region` string — The state of this job's address.
    - `location_postal_code` string — The postal code of this job's address.
    - `location_country` string — The country code of this job's address
    - `external_identifier` string — A unique identifier generated by the client. This can be anything you want and won't be changed. It can be used to reference an ID in the client application's database.
    - `suppress_email` string — If a value other than false is given for this attribute then all emails related to this job will be suppressed. That includes capture request emails.
  - `current_user_email` string — Required. The internal user that you want to assign the job to. Alternatively you can also use the current_user_id param.
  - `current_user_id` string — Required. The internal user that you want to assign the job to. Alternatively you can also use the current_user_id param.

## Response `200`

200

- object

## Other responses

- `400` — 400
- `500` — 500

---

[API](https://skmtc.net/hover/apis/hover-api-v3.md) · [All operations](https://skmtc.net/hover/apis/hover-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hover/hover-api-v3/versions/98ae3699d4c9/schema)