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.

• 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.