Sign in
Job Material Bundles

Update a Job Material Bundle

OAuth Scope

This endpoint requires the following OAuth scope manage_job_materials.

post/jobmaterialbundle/{uuid}.json

Path parameters

uuidstring uuid required

UUID of the Job Material Bundle

Request body

uuidstring uuid

Unique identifier for this record

item_numberstring

Unique identifier for the material bundle within the job. Displayed on the Quote/Invoice in the same way as for JobMaterials.

namestring

Descriptive name of the job material bundle. Displayed on the Quote/Invoice in the same way as for JobMaterials.

quantitystring

The quantity shown for the bundle line item on the invoice. Must be greater than zero. The quantity of each JobMaterial within the bundle is determined by dividing by this value.

sort_orderinteger

Defines the display order of the JobMaterialBundle relative to other JobMaterials and JobMaterialBundles on the Job. Lower values are displayed first.

material_bundle_uuidstring uuid

UUID of the MaterialBundle which this JobMaterialBundle was originally created from.

job_uuidstring uuid

UUID of the job that this material bundle is associated with. Links the bundle to a specific job record.

Example request

{
  "uuid": "123e4567-ed8b-4548-bc36-23f9491cc83b",
  "material_bundle_uuid": "123e4567-f0d0-4285-a620-23f946daf53b",
  "job_uuid": "123e4567-cc84-48f0-ae59-23f94554557b"
}

Response

Success - The record was updated successfully

errorCodenumber
messagestring

Example response

{
  "message": "OK"
}

Changes

Changed in 3 of the 50 revisions of this API.16

  • 638a8df09bf41See the full diff
    • ●

      removed the request property active

      request-property-removed

  • ca9b053c43735See the full diff
    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 429

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

  • c847f5f2f8d91See the full diff
    • ○

      the security scope manage_job_materials was added to the endpoint's security scheme oauth2

      api-security-scope-added