🔒
Requires read_product access scope.

The Update Supplier API allows users to modify existing supplier information in the system using the supplier's unique identifier.

This API is especially useful for:

Updating supplier contact URLs when websites change.
Correcting or updating supplier metadata in the system.

Note: The operation is scoped to a specific shop, identified by its unique domain prefix (shopdomain), ensuring all updates are applied to the correct store.

Request Parameters

Public Request Parameters

📘
Public Request Parameters

Path Parameters

Parameter	Type	Required	Description	Example
`id`	string	required	Supplier ID to update	`sup_123456`

Body Parameters

Parameter	Type	Required	Description	Example	Example
`supplier`	object	required	Object containing supplier details	`{...}`	`"next_page_token"`
`supplier.url`	string	optional	URL associated with the supplier	`https://acme.com`

Response Description

Public Response Fields

📘
Public Response Parameters

Success Response

Field	Type	Example	Description
`code`	string	`"success"`	Response status code
`message`	string		Descriptive message of the response
`data.supplier`	Supplier object

Supplier Object

Parameter	Type	Example	Description
`id`	`string`	`"sup_123"`	Unique supplier identifier
`title`	`string`	`"Acme Supplies"`	Name of the supplier
`url`	`string`	`"https://acme.example.com"`	Supplier website URL
`created_at`	`string`	`"2025-01-01T00:00:00Z"`	Creation timestamp (ISO 8601)
`updated_at`	`string`	`"2025-01-02T12:00:00Z"`	Last update timestamp (ISO 8601)

Error Response

Field	Type	Example	Description
`code`	string	`InvalidParameter`	Error http message
`message`	string	``	Error message

API Structure Overview