Delete a contractor

View as Markdown
DELETE /api/v1/contractors/{contractor}

Permanently deletes a contractor. It cannot be undone. Also immediately cancels any active policies connected with the contractor.

Path parameters

  • contractor string Required

    The ID of the desired contractor (e.g., cn_Ehb3bYa).

Responses

  • 200 application/json

    Returns an object with a deleted parameter on success. If the contractor ID does not exist, this call returns an error.

    Hide response attributes Show response attributes object
    • deleted boolean
    • deleted_at integer

      Unix timestamp (seconds since epoch) of when the contractor was deleted.

    • id string

      The contractor ID.

    • object string

      Default value is contractor.
DELETE /api/v1/contractors/{contractor} 
curl \
 --request DELETE 'https://api.1099policy.com/api/v1/contractors/cn_Ehb3bYa'
Response examples (200) 
{
  "id": "cn_Ehb3bYa",
  "object": "contractor",
  "deleted": true,
  "deleted_at": 1640995200
}