Update a policy

PUT /api/v1/policies/{policy_id}

Policies can be switched on and off using the is_active flag. Use this functionality if you don't have preset policy start and end times.

Path parameters

policy string Required

The ID of the desired policy (e.g., pl_WzFRszJhoY).

application/json

Body

is_active boolean

A flag to switch the policy on or off.

Responses

200 application/json

Returns the policy object if the update succeeded. Returns an error if update parameters are invalid.
Hide response attributes Show response attributes object
- certificates object
  
  URLs to the certificates of insurance for each of the types of coverage issued to the contractor for the specific job assignment.
  
  Hide certificates attributes Show certificates attributes object
  
  gl_coi_pdf_url string
  
  The general liability certificate of insurance PDF URL.
  
  wc_coi_pdf_url string
  
  The workers compensation certificate of insurance PDF URL.
- created integer(int64)
  
  Time at which the object was created. Measured in seconds since the Unix epoch.
- effective_date integer(int64)
  
  A timestamp used to determine the insurance policy start date. Measured in seconds since the Unix epoch. The default effective_date is the next day.
- expiration_date integer(int64)
  
  A timestemp used to determine the insurance policy end date. Measured in seconds since the Unix epoch. The default expiration_date is 30 days after the effective_date.
- id string
- pdf_url string
  
  A URL for the hosted insurnace policy PDF, which contractors can view.
- quote string
  
  The ID of the quote used to create the policy.
- status
  
  One of active, cancelled, or expired.
  
  Values are active, cancelled, or expired.

PUT /api/v1/policies/{policy_id}

curl \
 -X PUT https://api.1099policy.com/api/v1/policies/{policy_id} \
 -H "Content-Type: application/json" \
 -d '{"is_active":false}'

Request example

{
  "is_active": false
}

Response examples (200)

{
  "certificates": {
    "gl_coi_pdf_url": "/bound-policies/prod/gl_coi_pl_wv23Q3lMc1_1691450123.pdf",
    "wc_coi_pdf_url": "/bound-policies/prod/wc_coi_pl_wv23Q3lMc1_1691420903.pdf"
  },
  "created": 1646818364,
  "effective_date": 1646818364,
  "expiration_date": 1678334737,
  "id": "pl_WzFRszJhoY",
  "pdf_url": "http://ten99policy.s3.amazonaws.com/1099policy-coi-sample.pdf",
  "quote": "qt_5DciVga8Kt",
  "status": "active"
}