Managing Subcontractors

Subcontractors and suppliers are the people or companies who do the actual work on your projects. They are scoped to your user account.

Types and Kinds

Each subcontractor has two classification fields:

• Type: subcontractor (does work/services) or supplier (provides materials/products)
• Kind: company (an organization) or individual (a person)

Companies can have multiple contacts associated with them.

List Subcontractors

curl https://beta.renovatr.app/api/v1/subcontractors \
  -H "X-API-KEY: your-api-key-here"

Get a Subcontractor

curl https://beta.renovatr.app/api/v1/subcontractors/3 \
  -H "X-API-KEY: your-api-key-here"

Create a Subcontractor

curl -X POST https://beta.renovatr.app/api/v1/subcontractors \
  -H "X-API-KEY: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ABC Tiling Co.",
    "type": "subcontractor",
    "kind": "company",
    "email": "info@abctiling.com",
    "phone": "+1-555-0456",
    "specialty": "Tiling & flooring"
  }'

Fields

Field	Type	Required	Description
name	string	Yes	Name
type	string	No	subcontractor (default) or supplier
kind	string	No	company (default) or individual
email	string	No	Email address
phone	string	No	Phone number
specialty	string	No	Area of expertise
notes	string	No	Additional notes

Update a Subcontractor

curl -X PATCH https://beta.renovatr.app/api/v1/subcontractors/3 \
  -H "X-API-KEY: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{ "specialty": "Tiling, flooring & waterproofing" }'

Delete a Subcontractor

curl -X DELETE https://beta.renovatr.app/api/v1/subcontractors/3 \
  -H "X-API-KEY: your-api-key-here"

Project Subcontractors

You can also manage the subcontractors assigned to a specific project:

# List subcontractors for a project
curl https://beta.renovatr.app/api/v1/projects/1/subcontractors \
  -H "X-API-KEY: your-api-key-here"