---
title: "Update a vendor"
method: PATCH
path: "/v1/vendors/{vendor_id}"
tags: ["Vendors"]
---

# Update a vendor

`PATCH /v1/vendors/{vendor_id}`

## Path parameters

- `vendor_id` string, required

## Request body

- UpdateVendorOrganizationRequest — Every field is omit-to-preserve: only fields present in the request body are applied. All fields except email are non-nullable: their `default=None, validate_default=False` keeps them optional without advertising `null` as an accepted value, matching UpdateMarketRequest.
  - `name` string — Vendor name. Omit to leave unchanged.
  - `email` string, nullable — Vendor email. Omit to leave unchanged; pass null to clear it.
  - `reference_key` string — Vendor reference key. Omit to leave unchanged.
  - `is_enabled` boolean — Whether this vendor is assignable to new work. Omit to leave unchanged.
  - `market_ids` string[] — IDs of the markets this vendor serves. Omit to leave unchanged. A vendor with no market associations (empty list) serves all markets.

## Response `200`

OK

- VendorOrganizationResponse
  - `vendor` VendorOrganizationExternalSchema, required
    - `id` string, required
    - `name` string, required
    - `email` string, nullable, required
    - `reference_key` string, required — Optional unique identifier for this vendor in your system.
    - `is_enabled` boolean, required — Whether this vendor is enabled.
    - `market_ids` string[], required — IDs of the markets this vendor serves. A vendor with no market associations serves all markets.

---

[API](https://skmtc.net/navigateai/apis/navigateai-api.md) · [All operations](https://skmtc.net/navigateai/apis/navigateai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/navigateai/navigateai-api/revisions/5fb236d03a88/schema)