1099Policy API documentation

Update a job

PUT /api/v1/jobs/{job_id}

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

application/json

Body

address object
Hide address attributes Show address attributes
- country string | null
  
  2-letter country code.
- line1 string
  
  Address line 1 (Street address/PO Box).
- line2 string | null
  
  Address line 2 (Apartment/Suite/Unit/Building).
- locality string
  
  City/District/Suburb/Town/Village.
- postalcode string
  
  ZIP or postal code.
- region string
  
  2-letter state code.
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
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.
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).

Minimum value is 100, maximum value is 100000000.
wage_type

One of flatfee, hourly, unit or blended.

Values are flatfee, hourly, unit, or blended.
years_experience integer

The number of years of experience required to be eligible for the job.

Responses

• 200 application/json

Returns an job object if a valid job ID was provided. Returns an error otherwise.
Hide response attributes Show response attributes object
- address object
  
  Hide address attributes Show address attributes
  
  country string | null
  
  2-letter country code.
  
  line1 string
  
  Address line 1 (Street address/PO Box).
  
  line2 string | null
  
  Address line 2 (Apartment/Suite/Unit/Building).
  
  locality string
  
  City/District/Suburb/Town/Village.
  
  postalcode string
  
  ZIP or postal code.
  
  region string
  
  2-letter state code.
- 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)
  
  Time at which the object was created. Measured in seconds since the Unix epoch.
- 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.
- 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).
  
  Minimum value is 100, maximum value is 100000000.
- wage_type
  
  One of flatfee, hourly, unit or blended.
  
  Values are flatfee, hourly, unit, or blended.
- years_experience integer
  
  The number of years of experience required to be eligible for the job.

PUT /api/v1/jobs/{job_id}

curl \
 -X PUT https://api.1099policy.com/api/v1/jobs/{job_id} \
 -H "Content-Type: application/json" \
 -d '{"category_code":"jc_MTqpkbkp6G","custom_metadata":{"campaign":"Volvo"},"description":"Install fiber optic cable from back to the front of the store.","entity":"en_Ah3tqYn","name":"Field technician","wage":15000,"wage_type":"flatfee","years_experience":10}'

Request example

{
  "category_code": "jc_MTqpkbkp6G",
  "custom_metadata": {
    "campaign": "Volvo"
  },
  "description": "Install fiber optic cable from back to the front of the store.",
  "entity": "en_Ah3tqYn",
  "name": "Field technician",
  "wage": 15000,
  "wage_type": "flatfee",
  "years_experience": 10
}

Response examples (200)

{
  "allOf": [
    {
      "category_code": "jc_MTqpkbkp6G",
      "custom_metadata": {
        "campaign": "Volvo"
      },
      "description": "Install fiber optic cable from back to the front of the store.",
      "entity": "en_Ah3tqYn",
      "name": "Field technician",
      "wage": 15000,
      "wage_type": "flatfee",
      "years_experience": 10,
      "x-bump-ref-name": "job"
    },
    {
      "id": "jb_jsb9KEcTpc"
    }
  ]
}