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

# Update a vendor

`PATCH /v1/vendors/{vendor_id}`

## Request

- Base URL: `https://api.navigateai.co`
- URL: `https://api.navigateai.co/v1/vendors/{vendor_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/navigateai/apis/navigateai-api/docs/v1/vendors/:vendor_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/navigateai/apis/navigateai-api.md) - [All operations](https://skmtc.dev/navigateai/apis/navigateai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/navigateai/apis/navigateai-api/revisions/912b48581de7?raw)