# Update a job

**PUT /api/v1/jobs/{job}**

Updates the specific job by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

## Servers
- Production server: https://api.1099policy.com (Production server)

## Parameters

### Path parameters

- **job** (string)
  The ID of the desired job (e.g., `jb_jsb9KEcTpc`).

### Body: application/json (object)

- **address** (object)
  The job address where the work will be done. Exclude if job will be done remotely.

- **custom_metadata** (object)
  Set of key-value pairs that you can attach to an object. Used to store additional information about the job in a structured format.

The `purchase_order_number` key is recognized: invoices created for this job inherit it as their purchase order number (overridable or clearable per invoice via the invoice endpoints).

- **description** (string)
  A description of the job that includes the role, responsibilities and necessary qualifications.

- **entity** (string)
  The ID of an existing entity for whom the job is being done.

- **name** (string)
  The name of the contractor job role.

- **wage** (integer)
  A positive integer representing the wage (e.g., 1500 cents is $15.00). The minimum wage amount is 100 cents US. The maximum wage amount is 1000000000 cents US ($10,000,000).

- **wage_type** (string)
  One of `flatfee`, `hourly`, `unit` or `blended`.

- **withhold_premium** (boolean)
  This indicates whether the contractor is paying premium directly with their credit card (i.e., `false`) or if the contractor has given the platform that's integrating with 1099Policy permission to withhold the premium payment from their wages and pay the premium on the contractor's behalf (i.e., `true`). Defaults to `false`.

- **years_experience** (integer)
  The number of years of experience required to be eligible for the job.

## Responses
### 200
Returns a job object if a valid job ID was provided. Returns an error otherwise.

#### Body: application/json (object)
- **address** (object)

- **category_code** (string)
  The category code that 1099Policy creates for a group of similarly classified jobs.
  Job category codes are pre-approved by 1099Policy so you can offer contractors insurance to new jobs on your platform in real time.
  To generate pre-approved category codes for a group of similarly classified jobs visit the [1099Policy Dashboard](https://dashboard.1099policy.com/jobs).

- **created** (integer(int64))

- **custom_metadata** (object)
  Set of key-value pairs that you can attach to the job object. Used for storing additional information in a structured format. Individual keys can be unset by posting an empty value to them. Pass an empty value, e.g. {}, to custom_metadata to unset all keys.
  The `purchase_order_number` key is recognized: invoices created for this job inherit it as their purchase order number (overridable or clearable per invoice via the invoice endpoints).

- **description** (string)
  A description of the job that includes the role, responsibilities and necessary qualifications.

- **entity** (string)
  The entity ID for whom the work is being done.

- **id** (string)

- **name** (string)
  The name of the contractor job role.

- **wage** (integer)
  A positive integer representing the total wage (e.g., 1500 cents is $15.00). The minimum wage amount is 100 cents US. The maximum wage amount is 100000000 cents US ($1,000,000).

- **wage_type** ()
  One of `flatfee`, `hourly`, `unit` or `blended`.

- **years_experience** (integer)
  The number of years of experience required to be eligible for the job.