Skip to main content

carrierUpdate

Update an existing carrier's configuration.

Modifies carrier details including service type, localized descriptions, pricing information, tracking URL template, logo, and warehouse coverage areas. Only provided fields will be updated, others remain unchanged. Validates warehouse IDs against the warehouse service if provided.

Possible errors:

  • CARRIER_NOT_FOUND_ERROR: Carrier with the specified ID does not exist in the system
  • CARRIER_UPDATE_ERROR: Failed to update the carrier due to data source issues or warehouse validation failure
  • CARRIER_ALREADY_EXISTS_ERROR: Updated name conflicts with existing carrier within the organization
  • FORBIDDEN: Insufficient permissions to update carriers

AUTH: Role=[logistics.OWNER,logistics.EDITOR]

carrierUpdate(
  id: Int!
  input: CarrierUpdateInput!
): Carrier!

Arguments​

carrierUpdate.id ● Int! non-null scalar​

Unique identifier of the carrier to update.

Must be a positive integer representing a valid carrier ID in the system. This ID is used to locate the specific carrier for modification.

carrierUpdate.input ● CarrierUpdateInput! non-null input​

Updated carrier information.

Contains the carrier properties to update including name (maximum 64 characters), service type, localized descriptions, shipping cost, tracking URL template (HTTPS only), logo URL, and warehouse coverage areas. Only provided fields will be changed, others remain unchanged. All warehouse IDs are validated against the warehouse service.

Type​

Carrier object​

Shipping carrier configuration for logistics and delivery operations.

Represents a shipping company or service provider including service details, coverage areas, pricing information, and integration settings. Used for shipping calculations, order fulfillment, and logistics management.