---
title: "Update a specific material vendor. Use this endpoint instead of the path-based v1
when your material ids may contain '/' characters, which ASP.NET Core routing
cannot match once URL-encoded."
method: PUT
path: "/api/v2/material-vendors/{vendorId}"
tags: ["Material Vendor"]
---

# Update a specific material vendor. Use this endpoint instead of the path-based v1
when your material ids may contain '/' characters, which ASP.NET Core routing
cannot match once URL-encoded.

`PUT /api/v2/material-vendors/{vendorId}`

## Path parameters

- `vendorId` string, required

## Request body

- MaterialVendorUpdateMaterialVendorRequestDto — Request parameters for updating a vendor on a material. Introduced for the v2 endpoint because material ids may contain '/' characters, which cannot be round-tripped through URL path segments.
  - `materialId` string, required — Unique id of the material whose vendor will be updated.
  - `isPrimary` boolean — Signifies if this is the primary vendor for this material.
  - `leadTimeInDays` integer, nullable — Lead time for this vendor.
  - `priceBreaks` MaterialShapeVendorPriceBreakCreateDto[], required — Vendor price breaks
    - `quantity` integer, required — The minimum quantity to associate this price break to.
    - `price` number, double, required — The price per unit.

## Response `200`

Update successful

- MaterialShapeVendorDto — Material vendor definition
  - `id` string, uuid, required — Unique id associated to this entity.
  - `vendorId` string, required — Vendor identifier. Pelase reference /api/vendors endpoint.
  - `isPrimary` boolean, required — Signifies if this is the primary vendor for this material.
  - `currencyCode` string, nullable — Currency code/denomination associated to this vendor.
  - `priceUnit` 'kilogram' | 'pound', required — Specifies how a routing input item quantity is measured.
  - `leadTimeInDays` integer, nullable — Number of days required between order and receipt
  - `priceBreaks` MaterialShapeVendorPriceBreakDto[], required — Vendor price breaks
    - `id` string, uuid, required — Unique id associated to this entity.
    - `quantity` integer, required — The minimum quantity to associate this price break to.
    - `price` number, double, required — The price per unit.

## Other responses

- `404` — Material did not exist or no vendor existed

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)