Delete a supplier

DELETE

/suppliers/{id}

Soft-deletes the supplier and removes its link from every product that carried it, in one transaction, matching the behaviour of the admin app.

• Removing the link is a change to each affected product, so its version bumps and it reappears in the caller’s next delta-sync poll.

• A purchase order that named this supplier keeps its supplier_id. That reference is not nulled, and is left pointing at the deleted row.

• 404 NOT_FOUND: the id is foreign, unknown, or already deleted.

Requires scope: catalog:write

Authorizations

• apiKey
• oauth2
  catalog:write

Responses

204

Delete a supplier

Media typeapplication/json

No content.

object

Example^generated

{}

default

An error response.

Media typeapplication/json

object

error

required

object

code

required

A machine-readable error code, e.g. VALIDATION_FAILED.

string

Allowed values: UNAUTHORIZED PLAN_REQUIRED INSUFFICIENT_SCOPE NOT_FOUND VALIDATION_FAILED CONFLICT STALE_VERSION RATE_LIMITED IDEMPOTENCY_KEY_REUSED IDEMPOTENCY_IN_PROGRESS IMAGE_FETCH_FAILED UNPROCESSABLE INTERNAL RETAILER_CANCELLED RETAILER_SUSPENDED RETAILER_NOT_FOUND TRIAL_DECISION_REQUIRED PLAN_USERS_EXCEEDED RETAILER_PAUSED PRODUCT_LIMIT_REACHED NOT_STOCK_TRACKED REASON_DIRECTION_MISMATCH REASON_NOT_ALLOWED INSUFFICIENT_STOCK OUTLET_DELETED

fields

Array<object>

object

field

required

string

message

required

string

message

required

A plain-English sentence describing what went wrong.

string

Example

{
  "error": {
    "code": "UNAUTHORIZED"
  }
}