/buildops-service | Type: Application | PCID required: Yes
Tools
buildops-service_assign_v1_job_job_tag
Assign Job Tag to Job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | Job ID |
jobTagId | string | Yes | — | Job Tag Id |
buildops-service_create_v1_job_task
Create task in Job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | Job ID |
assetId | string | No | — | Associated asset ID |
description | string | No | — | Task description |
name | string | Yes | — | Task name |
taskEntries | object[] | No | — | Task entries containing products and quantities |
buildops-service_create_v1_property_task
Create task in property Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
propertyId | string | Yes | — | Property ID |
assetId | string | No | — | Associated asset ID |
description | string | No | — | Task description |
name | string | Yes | — | Task name |
taskEntries | object[] | No | — | Task entries containing products and quantities |
buildops-service_delete_v1_tasks_task_id
Delete task by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
taskId | string | Yes | — | Task ID |
buildops-service_get_job_by_id
Get Jobs List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number for pagination |
limit | integer | No | — | Number of items per page |
page_size | integer | No | — | Number of items per page |
job_number | string | No | — | Job number that you want to filter by. |
buildops-service_get_v1_departaments
Get Departments List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number for pagination |
page_size | integer | No | — | Number of items per page |
buildops-service_get_v1_departments_department_id
Get Department by Department ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
departmentId | string | Yes | — | Department ID |
buildops-service_get_v1_inventory_products_id
Get Inventory Product by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Inventory Product ID |
buildops-service_get_v1_job_tasks
Get all tasks on a Job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | Job ID |
buildops-service_get_v1_jobs_job_id
Get Job by Job ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | Job ID |
include | string | No | — | Allows to return relations |
buildops-service_get_v1_product_id
Get Product by Product ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
productId | string | Yes | — | Product ID |
buildops-service_get_v1_products
Get Products List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | No | — | Product Code |
page_size | integer | No | — | Number of items per page |
limit | string | No | — | How many items should come in the request. |
page | number | No | — | Page that you want to filter. |
buildops-service_get_v1_properties
Get Properties by tenantId Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
include_addresses | boolean | No | — | Allows to return properties with his addresses. |
page | integer | No | — | Page number for pagination |
page_size | integer | No | — | Number of items per page |
include_inactive | boolean | No | — | If this parameter is passed as true, this endpoint will return inactive vendors. |
buildops-service_get_v1_properties_id
Get Property By Property ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Property ID |
include_addresses | boolean | No | — | DEPRECATED: Use include instead. Include addresses. |
include | string[] | No | — | Allows to return relations |
buildops-service_get_v1_properties_tasks
Get all tasks on a property Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
propertyId | string | Yes | — | Property ID |
buildops-service_get_v1_property_history_id
Get Property History By PropertyId Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
propertyId | string | Yes | — | Property ID |
buildops-service_get_v1_representatives_id
Get Representative By ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Representative ID |
buildops-service_get_v1_task
Get task by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
taskId | string | Yes | — | Task ID |
buildops-service_get_v1_visits_id
Get Visit by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
include | string | No | — | Allows to return relations |
id | string | Yes | — | Visit ID |
buildops-service_get_v1_visits_list
Get Visits List Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | No | — | jobId for filtering visits |
page | integer | No | — | Page number for pagination |
page_size | integer | No | — | Number of items per page |
buildops-service_post_customers_id_reps
Add Customer Representative by customerId Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Customer ID |
bestContact | string | No | — | Best Contact |
cellPhone | string | No | — | Cell Phone |
contactRole | string | No | — | Contact Role |
contactType | string | No | — | Contact Type |
email | string | No | — | The email value |
firstName | string | No | — | First Name |
isDoNotCall | boolean | No | — | Is Do Not Call |
isEmailOptOut | boolean | No | — | Is Email Opt Out |
isSmsOptOut | boolean | No | — | Is Sms Opt Out |
landlinePhone | string | No | — | Landline Phone |
lastName | string | No | — | Last Name |
middleName | string | No | — | Middle Name |
name | string | No | — | The name value |
nickName | string | No | — | Nick Name |
profilePictureUrl | string | No | — | Profile Picture Url |
salutation | string | No | — | The salutation value |
userTitle | string | No | — | User Title |
buildops-service_post_v1_jobs
Create a Job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
accountingJobNumber | string | No | — | Accounting Job Number |
accountManagerId | string | No | — | Account Manager Id |
amountNotToExceed | number | No | — | Amount Not To Exceed |
amountPreTaxQuoted | number | No | — | Amount Pre Tax Quoted |
authorizedById | string | No | — | Authorized By Id |
billingCustomerId | string | No | — | Billing Customer Id |
blanketPOId | string | No | — | Blanket PO Id |
certifiedPayroll | boolean | No | — | Certified Payroll |
closeoutReport | boolean | No | — | Closeout Report |
costAmount | number | No | — | Cost Amount |
customerId | string | Yes | — | Customer Id |
customerPropertyId | string | Yes | — | Customer Property Id |
customerProvidedPONumber | string | No | — | Customer Provided PO Number |
customerProvidedWONumber | string | No | — | Customer Provided WO Number |
customerRepId | string | No | — | Customer Rep Id |
customIdentifier | string | No | — | Custom Identifier |
departmentIds | string[] | No | — | Department Ids |
detailedJobCostingEnabled | boolean | No | — | Detailed Job Costing Enabled |
dueDate | string | No | — | Due Date |
issueDescription | string | No | — | Issue Description |
isUseTaxable | boolean | Yes | — | Is Use Taxable |
jobTypeId | string | Yes | — | Job Type Id |
labourRateGroupId | string | No | — | Labour Rate Group Id |
ownerId | string | No | — | Owner Id |
preferredTechnicianId | string | No | — | Preferred Technician Id |
priceBookId | string | Yes | — | Price Book Id |
priority | string | No | — | The priority value |
serviceChannelDescription | string | No | — | Service Channel Description |
soldById | string | No | — | Sold By Id |
status | object | Yes | — | The status value |
taxAmountQuoted | number | No | — | Tax Amount Quoted |
totalBudgetedHours | number | No | — | Total Budgeted Hours |
buildops-service_post_v1_products
Create Product Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
category | string | No | — | Product category |
code | string | No | — | Product code |
costCodeId | string | No | — | Cost code identifier |
defaultFeeOnQuotes | boolean | No | — | Whether this product is a default fee on quotes |
defaultFeeOnTimeAndMaterialJobs | boolean | No | — | Whether this product is a default fee on time and material jobs |
defaultFeeOnTimeAndMaterialJobVisits | boolean | No | — | Whether this product is a default fee on time and material job visits |
description | string | Yes | — | Description of the product |
imageUrl | string | No | — | URL to product image |
isGeneric | boolean | Yes | — | Whether the product is generic. If false, manufacturer information is required. |
itemGlGroupId | string | No | — | Item GL group identifier |
jobCostTypeId | string | No | — | Job cost type identifier |
markupType | string | No | — | Markup type |
markupValue | number | No | — | Markup value for the product |
name | string | Yes | — | Name of the product |
productManufacturerId | string | No | — | Product manufacturer ID. Required when isGeneric is false. |
productManufacturerNumber | string | No | — | Product manufacturer number. Required when isGeneric is false. |
revenueTypeId | string | No | — | Revenue type identifier |
sku | string | No | — | Stock keeping unit |
subCategory | string | No | — | Product subcategory |
taxable | boolean | Yes | — | Whether the product is taxable |
taxCodeId | string | No | — | Tax code identifier |
type | string | Yes | — | Product type |
unitCost | number | Yes | — | Unit cost of the product |
unitOfMeasureId | string | No | — | Unit of measure identifier |
warrantyProvidedBy | string | No | — | Entity providing the warranty |
warrantyType | string | No | — | Type of warranty |
buildops-service_post_v1_properties
Create a Property Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
accountNumber | string | No | — | Account Number |
addressLine1 | string | No | — | Address Line1 |
addressType | string | No | — | Address Type |
billingCustomerId | string | No | — | Billing Customer Id |
billTo | string | No | — | Bill To |
city | string | No | — | The city value |
companyName | string | No | — | Company Name |
country | string | No | — | The country value |
customerId | string | Yes | — | Customer Id |
customerPropertyTypeValue | string | No | — | Customer Property Type Value |
isTaxable | boolean | No | — | Is Taxable |
latitude | number | Yes | — | The latitude value |
longitude | number | Yes | — | The longitude value |
priceBookId | string | No | — | Price Book Id |
sameAddress | boolean | No | — | Same Address |
state | string | No | — | The state value |
syncStatus | string | No | — | Sync Status |
taxCodeId | string | No | — | Tax Code Id |
zipcode | string | No | — | The zipcode value |
buildops-service_post_v1_properties_id_representatives
Create a Customer Representative with propertyId Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Property ID |
bestContact | string | No | — | Best Contact |
cellPhone | string | No | — | Cell Phone |
contactRole | string | No | — | Contact Role |
contactType | string | No | — | Contact Type |
email | string | No | — | The email value |
firstName | string | No | — | First Name |
isDoNotCall | boolean | No | — | Is Do Not Call |
isEmailOptOut | boolean | No | — | Is Email Opt Out |
isSmsOptOut | boolean | No | — | Is Sms Opt Out |
landlinePhone | string | No | — | Landline Phone |
lastName | string | No | — | Last Name |
middleName | string | No | — | Middle Name |
name | string | No | — | The name value |
nickName | string | No | — | Nick Name |
profilePictureUrl | string | No | — | Profile Picture Url |
salutation | string | No | — | The salutation value |
userTitle | string | No | — | User Title |
buildops-service_post_v1_visits_id_action
Update Visit Status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Visit ID |
action | string | No | — | The action value |
buildops-service_put_v1_customers_id_representatives_representative_id
Update Representative by representativeId at Customer Level Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Customer ID |
representative_id | string | Yes | — | Representative ID |
bestContact | string | No | — | Best Contact |
cellPhone | string | No | — | Cell Phone |
contactRole | string | No | — | Contact Role |
contactType | string | No | — | Contact Type |
email | string | No | — | The email value |
firstName | string | No | — | First Name |
isActive | boolean | No | — | Is Active |
isDoNotCall | boolean | No | — | Is Do Not Call |
isEmailOptOut | boolean | No | — | Is Email Opt Out |
isSmsOptOut | boolean | No | — | Is Sms Opt Out |
landlinePhone | string | No | — | Landline Phone |
lastName | string | No | — | Last Name |
middleName | string | No | — | Middle Name |
name | string | No | — | The name value |
nickName | string | No | — | Nick Name |
profilePictureUrl | string | No | — | Profile Picture Url |
salutation | string | No | — | The salutation value |
status | string | No | — | The status value |
userTitle | string | No | — | User Title |
version | number | No | — | The version value |
buildops-service_put_v1_jobs_job_id
Update Job by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | Job ID |
accountingJobNumber | string | No | — | Accounting Job Number |
accountManagerId | string | No | — | Account Manager Id |
amountNotToExceed | number | No | — | Amount Not To Exceed |
amountPreTaxQuoted | number | No | — | Amount Pre Tax Quoted |
authorizedById | string | No | — | Authorized By Id |
billingCustomerId | string | No | — | Billing Customer Id |
blanketPOId | string | No | — | Blanket PO Id |
certifiedPayroll | boolean | No | — | Certified Payroll |
closeoutReport | boolean | No | — | Closeout Report |
costAmount | number | No | — | Cost Amount |
customerId | string | No | — | Customer Id |
customerPropertyId | string | No | — | Customer Property Id |
customerProvidedPONumber | string | No | — | Customer Provided PO Number |
customerProvidedWONumber | string | No | — | Customer Provided WO Number |
customerRepId | string | No | — | Customer Rep Id |
departmentIds | string[] | No | — | Department Ids |
detailedJobCostingEnabled | boolean | No | — | Detailed Job Costing Enabled |
dueDate | string | No | — | Due Date |
issueDescription | string | No | — | Issue Description |
isUseTaxable | boolean | No | — | Is Use Taxable |
jobTypeId | string | No | — | Job Type Id |
labourRateGroupId | string | No | — | Labour Rate Group Id |
ownerId | string | No | — | Owner Id |
preferredTechnicianId | string | No | — | Preferred Technician Id |
priceBookId | string | No | — | Price Book Id |
priority | string | No | — | The priority value |
serviceChannelDescription | string | No | — | Service Channel Description |
soldById | string | No | — | Sold By Id |
status | object | No | — | The status value |
taxAmountQuoted | number | No | — | Tax Amount Quoted |
totalBudgetedHours | number | No | — | Total Budgeted Hours |
version | integer | No | — | The version value |
buildops-service_put_v1_products_id
Update a Product by Product ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
productId | string | Yes | — | Product ID |
accountingRefId | string | No | — | Accounting Ref Id |
code | string | No | — | The code value |
costCodeId | string | No | — | Cost Code Id |
description | string | No | — | The description value |
itemGlGroupId | string | No | — | Item Gl Group Id |
jobCostTypeId | string | No | — | Job Cost Type Id |
markupType | string | No | — | Markup Type |
markupValue | number | No | — | Markup Value |
name | string | No | — | The name value |
revenueTypeId | string | No | — | Revenue Type Id |
syncStatus | string | No | — | Sync Status |
taxable | boolean | No | — | The taxable value |
unitCost | number | No | — | Unit Cost |
unitOfMeasureId | string | No | — | Unit Of Measure Id |
unitPrice | number | No | — | Unit Price |
buildops-service_put_v1_properties_id
Update Property By Property ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Property ID |
accountNumber | string | No | — | Account Number |
billingCustomerId | string | No | — | Billing Customer Id |
billTo | string | No | — | Bill To |
companyName | string | No | — | Company Name |
customerPropertyTypeValue | string | No | — | Customer Property Type Value |
isActive | boolean | No | — | Is Active |
isTaxable | boolean | No | — | Is Taxable |
priceBookId | string | No | — | Price Book Id |
sameAddress | boolean | No | — | Same Address |
status | string | No | — | The status value |
taxCodeId | string | No | — | Tax Code Id |
buildops-service_put_v1_properties_id_representatives_representative_id
Update Customer Representative through property with representativeId Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
representative_id | string | Yes | — | Customer Representative ID |
id | string | Yes | — | Property ID |
bestContact | string | No | — | Best Contact |
cellPhone | string | No | — | Cell Phone |
contactRole | string | No | — | Contact Role |
contactType | string | No | — | Contact Type |
email | string | No | — | The email value |
firstName | string | No | — | First Name |
isActive | boolean | No | — | Is Active |
isDoNotCall | boolean | No | — | Is Do Not Call |
isEmailOptOut | boolean | No | — | Is Email Opt Out |
isSmsOptOut | boolean | No | — | Is Sms Opt Out |
landlinePhone | string | No | — | Landline Phone |
lastName | string | No | — | Last Name |
middleName | string | No | — | Middle Name |
name | string | No | — | The name value |
nickName | string | No | — | Nick Name |
profilePictureUrl | string | No | — | Profile Picture Url |
salutation | string | No | — | The salutation value |
status | string | No | — | The status value |
userTitle | string | No | — | User Title |
version | number | No | — | The version value |
buildops-service_remove_v1_job_job_tag
Remove Job Tag from Job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
jobId | string | Yes | — | Job ID |
tagId | string | Yes | — | Job Tag ID |
buildops-service_update_v1_task
Update task by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
taskId | string | Yes | — | Task ID |
assetId | string | No | — | Asset Id |
description | string | No | — | The description value |
formIds | string[] | No | — | Form Ids |
name | string | No | — | The name value |
taskEntries | object[] | No | — | Task Entries |
buildops-service_v1_get_customers_our_representatives
Get Our Representatives List by customerId Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number for pagination |
page_size | integer | No | — | Number of items per page |
id | string | Yes | — | Customer ID |

