> ## Documentation Index > Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt > Use this file to discover all available pages before exploring further. # UpdateConnectorCommandRequestInput > Partially updates an existing JTL-Connector account. Every field is optional: a field present in the request body is changed, a field left out keeps its persisted value (May PATCH semantics). The writable field set is the writable half of CreateConnector, property for property, and the response is the same full Connector object - create an account, then patch any subset of the same fields. Only locally editable data is writable here: tShop base data, the connection credentials and tShopKonfiguration. The connector-driven sections (Languages, Currencies, Features, TaxRates, ServerInfo) are response-only and are never accepted as request input, for the same reason as in CreateConnector. Changing Url or ApiToken is not a local write: the persisted metadata mirror describes one specific endpoint, so a connection change is verified against the connection the account would end up with, before anything is written, and the request fails without persisting when that handshake does not succeed. The mirror itself is not refreshed here - the shared refresh service is WAWI-91762 and has no code yet, so until it lands the mirror is brought up to date by RefreshConnector or the next Abgleich. A request that changes neither - or submits the values the account already has - performs a purely local persist with no live call. There is deliberately no ?simulate switch: testing a connection before an account exists is CreateConnector's ?simulate=true, and testing an existing account's credentials is AuthenticateConnector (WAWI-90496). This monolithic PATCH deliberately overlaps the section-based save family (WAWI-90485 configuration, WAWI-90494 credentials); the team decided on 2026-08-26 to build both and remove one later. - Request **Kind**: `input` ## Fields **`salesChannelId`**: `String!` (required) Sales channel id of the connector account to update. --- **`url`**: `String` URL of the connector endpoint. Omit to leave unchanged. Connection data - submitting a different value triggers the live handshake, which must succeed before anything is written. --- **`apiToken`**: `String` API token used to authenticate against the connector endpoint. Omit to leave unchanged. Write-only - never echoed back, and no response model of this API exposes it. Connection data - a new token triggers the live handshake, which must succeed before anything is written, and discards any Connector session cached for this account so the next call authenticates with the new token. --- **`name`**: `String` Name of the connector account. Omit to leave unchanged. --- **`companyId`**: `ID` ID of the company the connector account belongs to. Omit to leave unchanged. Cannot be cleared - the company is mandatory at creation and is the company whose tSteuersatz the endpoint-reported taxrates are validated against. --- **`isActive`**: `Boolean` Connector account is active. Omit to leave unchanged. --- **`isLocked`**: `Boolean` Connector account is locked. Omit to leave unchanged. --- **`rootCategoryId`**: `ID` Root category for imported items. Omit to leave unchanged; send null to clear it. --- **`useShopOrderNumber`**: `Boolean` Use the shop-assigned order number instead of the Wawi-generated one. Omit to leave unchanged. --- **`canImport`**: `Boolean` The connector account is allowed to import data from the endpoint. Omit to leave unchanged. --- **`shouldImportItemsAndCategories`**: `Boolean` Items and categories are imported. Omit to leave unchanged. --- **`shouldImportOrdersAndCustomers`**: `Boolean` Orders and customers are imported. Omit to leave unchanged. --- **`shouldImportImages`**: `Boolean` Item images are imported. Omit to leave unchanged. --- **`canUpload`**: `Boolean` The connector account is allowed to upload data to the endpoint. Omit to leave unchanged. --- **`shouldUploadItemComplete`**: `Boolean` Items are uploaded completely, rather than price/stock-restricted. Omit to leave unchanged. --- **`shouldUploadItemPriceRestricted`**: `Boolean` Item uploads are restricted to prices only. Omit to leave unchanged. --- **`shouldUploadItemStockRestricted`**: `Boolean` Item uploads are restricted to stock only. Omit to leave unchanged. --- **`shouldUploadCustomers`**: `Boolean` Customer data is uploaded. Omit to leave unchanged. --- **`shouldUploadImages`**: `Boolean` Images are uploaded. Omit to leave unchanged. --- **`shouldRefreshExistingItems`**: `Boolean` Existing items are merged/refreshed rather than only added. Omit to leave unchanged. --- **`shouldRefreshCustomers`**: `Boolean` Existing customer data is refreshed. Omit to leave unchanged. --- **`shouldDeleteImagesOnImport`**: `Boolean` Images are deleted on import. Omit to leave unchanged. --- **`shouldWawiCalculateTaxRate`**: `Boolean` The Wawi calculates the tax rate for items, rather than taking the endpoint-reported one. Omit to leave unchanged. --- **`shouldWawiCalculateTaxRateForShipping`**: `Boolean` The Wawi calculates the tax rate for shipping, rather than taking the endpoint-reported one. Omit to leave unchanged. --- **`shippingCountryIso`**: `String` The shipping/departure country as an ISO 3166-1 alpha-2 country code. Omit to leave unchanged; send null to clear it. Canonical form is UPPERCASE (ADR-85); matching is case-insensitive. --- **`entityCount`**: `Int` Maximum number of entities transferred per run. Omit to leave unchanged; send null for unrestricted. --- **`pullCount`**: `Int` Maximum pull count per sync run. Omit to leave unchanged. Not nullable - the column carries a definite value, so there is no unrestricted state to express. --- **`imagesCount`**: `Int` Maximum number of images transferred per run. Omit to leave unchanged; send null for unrestricted. --- **`maximumTransferRate`**: `Decimal` Maximum transfer rate for uploads, in megabytes. Omit to leave unchanged; send null for unrestricted. --- **`quickSyncCount`**: `Int` Maximum quick-sync count per sync run. Omit to leave unchanged. Not nullable, for the same reason as PullCount. --- **`sendOnlyAssignedManufacturers`**: `Boolean` Manufacturer data sent to the endpoint is filtered to only assigned manufacturers. Omit to leave unchanged. --- **`idempotencyKey`**: `String` Client-supplied idempotency key. When provided, a repeated request with the same key and payload replays the original result instead of re-executing the mutation.