salesChannelArchive
Archives a sales channel. Archived channels are hidden from channel lists and pickers and cannot receive new orders. Existing orders, financials, and reports keep showing them.
Business Rules
- The default sales channel cannot be archived. Set another default first.
- A channel that an active integration sends new orders to cannot be archived. Point the integration at another channel first.
- Archiving does not cascade. Integration mappings, product listings, prices, and warehouse settings stay as they are, so restoring the channel brings it back unchanged.
- The handle stays reserved while the channel is archived.
- Use
archiveBlockingReasonson the sales channel to check before archiving.
Error Scenarios
- **
NOT_FOUND**: the sales channel does not belong to this company. - **
CONFLICT**: the channel is already archived, or an archiving rule blocks it. The message lists every reason.
Permissions Required
orders:archive_sales_channelpermission.
salesChannelArchive(
input: SalesChannelArchiveInput!
): SalesChannel!
Arguments
salesChannelArchive.input ● SalesChannelArchiveInput! non-null input common
Parameters for SalesChannelArchive
Type
SalesChannel object sales-channels
Sales Channel
Represents a sales channel within a brand. Sales channels define different sources through which orders can be placed and managed, including configuration for routing, fulfillment, and order processing behavior.