Sign in
Job

Partially update a job

patch/api/jobs/{jobId}

Path parameters

jobIdstring required

Response

Job item

idstring required

Unique Id associated to this entity

numberinteger required

Job number

namestring required

Job name, defaults to number unless otherwise specified.

parentItemIdstring required

Unique identifier of the parent item produced by this job. Please reference api/items endpoint.

quantityToMakenumber double required

Quantity of parent item produced by this job

productionDueDatestring date-time nullable

Due date

earliestStartDatestring date-time nullable

If set, this is the earliest date that the job should be scheduled to begin.

salesOrderIdstring nullable

Identifier of sales order fulfilled by this job, if applicable. Please reference api/sales-orders endpoint.

salesOrderLineItemIdstring nullable

Identifier of sales order line item fulfilled by this job, if applicable. Please reference endpoints nested under api/sales-orders.

createdUtcstring date-time

The date the job was created

originalScheduledStartUtcstring date-time nullable

The first scheduled start time.

originalScheduledEndUtcstring date-time nullable

The first scheduled end time.

scheduledStartUtcstring date-time nullable

The current scheduled start time.

scheduledEndUtcstring date-time nullable

The current scheduled end time.

completedOnUtcstring date-time nullable

The job completion datetime.

cancelledOnUtcstring date-time nullable

The job cancelled datetime.

revenuenumber double nullable

Revenue

notesstring nullable

Job level internal notes

workOrderIdsstring[] required

Identifier of work order(s) that this job is associated to, if applicable. Please reference api/work-orders endpoint.

status'draft' | 'needsReview' | 'approved' | 'engineering' | 'scheduled' | 'inProgress' | 'complete' | 'cancelled' | 'hold' required

Job status

priority'low' | 'moderate' | 'high' required

Job priority

customFieldsobject nullable

Custom fields that have been defined on this entity.

Changes

Changed in 2 of the 23 revisions of this API.12

  • d743ab8b105f11See the full diff
    • ▲

      the / request property type changed from string to no type

      request-property-type-changed

    • ○

      added the new optional request property /

      new-optional-request-property

  • c002514312371See the full diff
    • ○

      added the non-success response with the status

      response-non-success-status-added