Update a contractor Run in API Explorer
Updates the specified contractor by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
This request accepts mostly the same arguments as the contractor creation call.
Path parameters
-
contractor
string Required The ID of the desired contractor (e.g.,
cn_Ehb3bYa
).
Body
-
address
object The contractor's home address.
Additional properties are allowed.
-
company_name
string The contractor's business name.
-
custom_metadata
object Set of key-value pairs that you can attach to an object. Used to store additional information about the contractor 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.
Additional properties are allowed.
-
email
string The contractor's email address.
-
first_name
string The contractor's first name.
-
last_name
string The contractor's last name.
-
middle_name
string The contractor's middle name.
-
phone
string The contractor's phone number.
curl \
--request PUT 'https://api.1099policy.com/api/v1/contractors/{contractor_id}' \
--header "Content-Type: application/json" \
--data '{"email":"[email protected]","phone":"415-474-9088","address":{"line1":"123 Main St.","region":"CA","locality":"San Francisco","postalcode":"94105"},"last_name":"Parker","first_name":"Joe","middle_name":"Doe","company_name":"Acme Co.","custom_metadata":{"campaign":"Red Bull"}}'
{
"email": "[email protected]",
"phone": "415-474-9088",
"address": {
"line1": "123 Main St.",
"region": "CA",
"locality": "San Francisco",
"postalcode": "94105"
},
"last_name": "Parker",
"first_name": "Joe",
"middle_name": "Doe",
"company_name": "Acme Co.",
"custom_metadata": {
"campaign": "Red Bull"
}
}
{
"address": {
"country": "null",
"line1": "92 Geary St",
"line2": "null",
"locality": "San Francisco",
"postalcode": 94114,
"region": "CA"
},
"company_name": "Acme Co.",
"created": 1646818364,
"custom_metadata": {
"campaign": "Red Bull"
},
"email": "[email protected]",
"first_name": "Joe",
"id": "cn_Ehb3bYa",
"last_name": "Parker",
"middle_name": "null",
"phone": "415-474-9088",
"withhold_premium": false
}