Update job

put

https://integrate.rooflink.com/roof_link_endpoints/api/light/public/jobs/{id}/

Performs a full update of a job. All fields become optional during updates. Note that insurance_claim and note fields cannot be updated (they are only available during creation). If customer.first_name is provided, it must still meet the minimum 1 character requirement

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

integer

required

≥ 1

Unique identifier of the job to update

Body Params

Complete job data for update. All fields are optional during updates. Cannot include insurance_claim or note fields

Comprehensive job information for updating a roofing project. All fields are optional during updates

name

string | null

Custom name or title for the job

job_type

string

enum

length ≤ 20

Defaults to r

Type of roofing job:

Code	Meaning
c	Commercial
r	Residential
d	Designer
m	MRP (Maintenance and Repair Program)

Allowed:

bid_type

string | null

enum

Type of bid or payment method:

Code	Meaning
c	Cash Bid
i	Insurance Bid
r	Repair
f	Finance

Allowed:

lead_source

integer | null

Unique identifier of the lead source (marketing channel or referral source)

address

string | null

Street address of the job location

city

string | null

City where the job is located

county

string | null

County where the job is located

state

string | null

Two-letter state or province code

zipcode

string | null

Postal or ZIP code

region

integer | null

Unique identifier of the region or territory

rep

integer | null

Unique identifier of the primary sales representative. Must be an employee from the authenticated user's company

rep_2

integer | null

Unique identifier of the secondary sales representative. Must be an employee from the authenticated user's company

marketing_rep

integer | null

Unique identifier of the marketing representative. Must be an employee from the authenticated user's company

project_manager

integer | null

Unique identifier of the project manager. Must be an employee from the authenticated user's company

management_company

integer | null

Unique identifier of the property management company associated with this job

pre_insurance_reviewer

integer | null

Unique identifier of the pre-insurance reviewer. Must be an employee from the authenticated user's company

post_insurance_reviewer

integer | null

Unique identifier of the post-insurance reviewer. Must be an employee from the authenticated user's company

date_signed

date-time | null

ISO 8601 timestamp when the contract was signed by the customer

date_completed

date-time | null

ISO 8601 timestamp when the work was completed

disclaimers

string | null

Marketing disclaimers or legal notices

ad_id

string | null

Advertisement identifier for tracking

ad_name

string | null

Advertisement name or title

adset_id

string | null

Ad set identifier for campaign tracking

adset_name

string | null

Ad set name or title

campaign_id

string | null

Marketing campaign identifier

campaign_name

string | null

Marketing campaign name

platform

string | null

Marketing platform where the lead originated

retailer_item_id

string | null

Retailer item identifier for inventory tracking

company_cam_id

string | null

CompanyCam project identifier for photo management integration

sales_rabbit_company_id

string | null

SalesRabbit company identifier

sales_rabbit_lead_id

integer | null

SalesRabbit lead identifier

sales_rabbit_rep_id

string | null

SalesRabbit representative identifier for the primary rep

sales_rabbit_rep_2_id

string | null

SalesRabbit representative identifier for the secondary rep

warranty_voided

boolean

Defaults to false

Indicates whether the warranty has been voided

exclude_from_qb

boolean

Defaults to false

If true, excludes this job from QuickBooks synchronization

custom_data

object | null

Custom field data defined by the company. Structure varies based on company configuration

extra_info

object | null

Additional information storage. Structure is flexible and varies by use case

customer

object | null

Customer contact information. If provided, first_name must meet the minimum 1 character requirement

coordinates

object | null

Geographic coordinates specifying a location on Earth

created_from_location

object | null

Geographic coordinates specifying a location on Earth

lead_status_info

object | null

Lead status information tracking the current stage of the job in the sales pipeline

approved_step

object | null