---
title: "Partially update a vendor"
method: PATCH
path: "/api/vendors/{vendorId}"
tags: ["Vendor"]
---

# Partially update a vendor

`PATCH /api/vendors/{vendorId}`

## Path parameters

- `vendorId` string, required

## Response `200`

Vendor item

- VendorDto — A vendor
  - `id` string, required — Id
  - `name` string, required — The name to give the vendor. Must be unique to all active vendors.
  - `vendorCode` string, nullable — Unique identifier for this vendor.
  - `paymentTermsId` string, nullable — Payment terms identifier. Please reference /api/payment-terms endpoint.
  - `paymentTerms` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `notes` string, nullable — General notes associated to this vendor
  - `externalReferences` object, nullable — External references associated with this entity.
  - `customFields` object, nullable — Custom fields that have been defined on this entity.
  - `currencyCode` string, nullable — The currency of the vendor.
  - `status` string, nullable — Approval/quality status of the vendor. One of: Approved, Probation, Monitor, Disqualified, Other.
  - `active` boolean — Whether the vendor is active.
  - `leadTime` integer, nullable — Default lead time in days.
  - `url` string, uri, nullable — Vendor website URL.
  - `vendorSince` string, date-time, nullable — Date the vendor relationship began.

## Other responses

- `400` — The patch could not be applied — the patch document is malformed (an unknown path, an unsupported operation, or a value the target field cannot hold), or the patched result failed validation
- `404` — Vendor did not exist

## Changes

- **2026-09-24** `d743ab8b105f` — 1 breaking, 1 info
  - the `items/value` request property type changed from `string` to no type
  - added the new optional request property `items/from`
- **2026-09-11** `c00251431237` — 1 info
  - added the non-success response with the status `400`

[Change history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/vendors/:vendorId/patch.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/e584a13d530a?raw)