Skip to main content
PUT
Full-replaces a single sub-supplier.

Headers

X-Delogue-Api
string

Path Parameters

id
string
required

The unique identifier of the sub-supplier to operate on.

Body

name
null | string

Display name of the sub-supplier company. Required; it cannot be null or empty.

customId
null | string

Customer-defined identifier for the sub-supplier. On a full replace, sending null clears the stored value.

relationType
null | enum<string>

The commercial relationship the sub-supplier has with the supplier organization. On a full replace, sending null clears it.

Available options:
distributor,
itemSupplier,
sourcingAgency,
styleSupplier
address
null | string

Street address of the sub-supplier. On a full replace, sending null clears the stored value.

zipCode
null | string

Postal or ZIP code of the sub-supplier's location. On a full replace, sending null clears the stored value.

city
null | string

City of the sub-supplier's location. On a full replace, sending null clears the stored value.

stateOrRegion
null | string

State, province, or region of the sub-supplier's location. On a full replace, sending null clears the stored value.

countryCode
null | string

Country code of the sub-supplier's location, such as CN. On a full replace, sending null clears the stored value.

latitude

Latitude of the sub-supplier's location in decimal degrees. On a full replace, sending null clears the stored value.

longitude

Longitude of the sub-supplier's location in decimal degrees. On a full replace, sending null clears the stored value.

webSite
null | string

Website URL of the sub-supplier. On a full replace, sending null clears the stored value.

vatNumber
null | string

VAT registration number of the sub-supplier. On a full replace, sending null clears the stored value.

mid
null | string

Manufacturer Identification (MID) number used for customs and import documentation. On a full replace, sending null clears it.

avatarColor
null | string

Hex color for the sub-supplier's avatar in the UI, without a leading hash character. On a full replace, sending null clears it.

state
null | enum<string>

The lifecycle state to assign on a full replace. Required. Deletion is not permitted here; use the DELETE endpoint to remove a sub-supplier.

Available options:
active,
archived,
deleted
contacts
null | object[]

The complete set of contacts for the sub-supplier. On a full replace, this list replaces all existing contacts.

Response

OK

status
enum<string>
required

The coarse outcome of the request, indicating whether it succeeded or failed.

Available options:
success,
error
code
string
required

The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire.

data
null | object
required

The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value.