> To build or manage a Wix site with an AI agent, follow https://www.wix.com/headless/skill.md
> It builds a new Wix site or puts your own site online, from a prompt, and keeps changing it afterwards. The pages are code in any web technology, and Wix runs the backend.
> It works through the Wix plugin (the Wix MCP and the Wix skills), the Wix CLI or no Wix login, and puts the site live on Wix hosting or on another host.
> Business features include a store, bookings, events and tickets, a restaurant, a blog, forms, members and many more.
> Read the Wix skills online at https://www.wix.com/skills
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# UpdatePackageExternalId

# Package: resellers

# Namespace: Packages

# Method link: https://dev.wix.com/docs/api-reference/account-level/resellers/packages-and-product-instances/update-package-external-id.md

## Introduction

Updates a package's external ID field.

---

## REST API

### Schema

```
 Method: updatePackageExternalId
 Description: Updates a package's external GUID field.
 URL: https://www.wixapis.com/resellers/v1/packages/update/{packageId}/{externalId}
 Method: PATCH
 Return type: UpdatePackageExternalIdResponse
  - name: updatedPackage | type: Package | description: Updated package.  
     - name: id | type: string | description: Package GUID.  | read-only: true | validation: format GUID
     - name: accountId | type: string | description: Wix account GUID. See [Account Level APIs](https://dev.wix.com/docs/rest/account-level/about-account-level-apis.md) for more details.  | read-only: true | validation: format GUID
     - name: externalId | type: string | description: External reference. For example, an external subscription GUID. This field isn't validated by Wix.  Max: 100 characters  | validation: maxLength 100
     - name: productInstances | type: array<ProductInstance> | description: Product instances that are included in the package.  Min: 1 product instance Max: 1000 product instances  | validation: minItems 1, maxItems 1000
        - ONE-OF: 
           - name: billingInfo | type: Cycle | description: Billing information for the contract between the reseller and Wix.  
              - name: type | type: CycleDescriptorType | description: Payment type.  
                     - enum:
                     -     ONE_TIME: The reseller pays Wix in a single payment.
                     -     RECURRING: The reseller pays Wix on a recurring schedule.
              - name: cycleDuration | type: Interval | description: Duration of the billing cycle. Available only for `RECURRING` payments.  
                 - name: unit | type: IntervalUnit | description: Unit of the billing cycle.  
                         - enum:
                         -     DAY: Day
                         -     WEEK: Week
                         -     MONTH: Month
                         -     YEAR: Year
                 - name: count | type: integer | description: Count of units that make up the billing cycle.  | validation: minimum 1
        - name: instanceId | type: string | description: GUID of the instance of the resold Wix service. **Note:** Differs from the `catalogProductId`. Allows you to identify different instances of the same product in a package.  | read-only: true | validation: format GUID
        - name: siteId | type: string | description: GUID of the Wix site that the product instance is assigned to. See the [Query Sites API](https://dev.wix.com/api/rest/account-level-apis/sites/query-sites) for more information.  | validation: format GUID
        - name: catalogProductId | type: string | description: Product GUID, as defined in the Wix Premium Product Catalog. Contact the [Wix B2B sales team](mailto:bizdev@wix.com) for more details about available Wix services.  | validation: format GUID
        - name: status | type: Status | description: Status of the product instance.  | read-only: true 
             - enum:
             -     PENDING: The product instance isn't yet available to the customer.
             -     ENABLED: The customer can use the product instance.
             -     CANCELED: The product instance isn't any longer available to the customer.
             -     FAILED: The product instance couldn't be delivered successfully and has never been available to the customer.
             -     AWAITING_ACTION: The product instance isn't yet available to the customer, because an external provider or the customer must take an action.
        - name: failure | type: FailureReason | description: Failure object. Only present for status `FAILED`. Describes why the product instance `FAILED`.  | read-only: true 
           - name: code | type: FailureReasonCode | description: Failure code.  
                 - enum:
                 -     DELIVERY_TIMEOUT: The product instance couldn't be created because the Resellers API timed out.
                 -     EXTERNAL_FAILURE: The product instance couldn't be created because an external process failed.
           - name: message | type: string | description: Failure message.  
        - name: createdDate | type: string | description: Date and time the product instance was created.  | read-only: true | validation: format date-time
        - name: updatedDate | type: string | description: Date and time the product instance was last updated.  | read-only: true | validation: format date-time
        - name: countryCode | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. Specifies where customers can claim vouchers that may come with the product. Contact the [Wix B2B sales team](mailto:bizdev@wix.com) to get more information about vouchers and supported locations.  | validation: format COUNTRY
        - name: expirationDate | type: string | description: Date and time the product instance expires in `YYYY-MM-DDThh:mm:ss.sssZ` format. Used only for instances that don't auto renew at the end of the current billing cycle.  | read-only: true | validation: format date-time
        - name: discountCode | type: string | description: Discount code indicating that the reseller provisioned the product instance during a sale. Wix doesn't guarantee that a discount code reduces the price between Wix and the reseller, even when it's valid. Contact the [Wix B2B sales team](mailto:bizdev@wix.com) for more information.  Max: 25 characters  | validation: maxLength 25
        - name: referenceProductInstanceId | type: string | description: GUID of a different product instance that you can use to offer your customers time-limited free access to an additional product or service. For example, Wix offers a 1-year free domain registration to all customers who purchase a Premium plan. The referenced product instance must have either status `"PENDING"` or `"ACTIVE"`. You can use each product instance only a single time as reference instance.  | validation: format GUID
     - name: createdDate | type: string | description: Date and time the package was created.  | read-only: true | validation: format date-time
     - name: updatedDate | type: string | description: Date and time the package was last updated.  | read-only: true | validation: format date-time


```

### Examples

### Update the package externalId
```curl
curl -X patch \
'https://www.wixapis.com/resellers/v1/packages/update/<PACKAGE_ID>/<EXTERNAL_ID>' \
-H 'wix-account-id: <ACCOUNT_ID>' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.packages.packages.updatePackageExternalId(identifiers)
 Description: Updates a package's external GUID field.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  identifiers.packageId, identifiers.externalId, identifiers
 Method parameters: 
   param name: identifiers | type: UpdatePackageExternalIdIdentifiers  none | required: true 
        - name: packageId | type: string | description: GUID of the package to update. | required: true | validation: format GUID
        - name: externalId | type: string | description: External GUID that will be assigned to the package. | required: true | validation: maxLength 100
 Return type: PROMISE<UpdatePackageExternalIdResponse>
  - name: updatedPackage | type: Package | description: Updated package.  
     - name: _id | type: string | description: Package GUID.  | read-only: true | validation: format GUID
     - name: accountId | type: string | description: Wix account GUID. See [Account Level APIs](https://dev.wix.com/docs/rest/account-level/about-account-level-apis.md) for more details.  | read-only: true | validation: format GUID
     - name: externalId | type: string | description: External reference. For example, an external subscription GUID. This field isn't validated by Wix.  Max: 100 characters  | validation: maxLength 100
     - name: productInstances | type: array<ProductInstance> | description: Product instances that are included in the package.  Min: 1 product instance Max: 1000 product instances  | validation: minItems 1, maxItems 1000
        - ONE-OF: 
           - name: billingInfo | type: Cycle | description: Billing information for the contract between the reseller and Wix.  
              - name: type | type: CycleDescriptorType | description: Payment type.  
                     - enum:
                     -     ONE_TIME: The reseller pays Wix in a single payment.
                     -     RECURRING: The reseller pays Wix on a recurring schedule.
              - name: cycleDuration | type: Interval | description: Duration of the billing cycle. Available only for `RECURRING` payments.  
                 - name: unit | type: IntervalUnit | description: Unit of the billing cycle.  
                         - enum:
                         -     DAY: Day
                         -     WEEK: Week
                         -     MONTH: Month
                         -     YEAR: Year
                 - name: count | type: integer | description: Count of units that make up the billing cycle.  | validation: minimum 1
        - name: instanceId | type: string | description: GUID of the instance of the resold Wix service. **Note:** Differs from the `catalogProductId`. Allows you to identify different instances of the same product in a package.  | read-only: true | validation: format GUID
        - name: siteId | type: string | description: GUID of the Wix site that the product instance is assigned to. See the [Query Sites API](https://dev.wix.com/api/rest/account-level-apis/sites/query-sites) for more information.  | validation: format GUID
        - name: catalogProductId | type: string | description: Product GUID, as defined in the Wix Premium Product Catalog. Contact the [Wix B2B sales team](mailto:bizdev@wix.com) for more details about available Wix services.  | validation: format GUID
        - name: status | type: Status | description: Status of the product instance.  | read-only: true 
             - enum:
             -     PENDING: The product instance isn't yet available to the customer.
             -     ENABLED: The customer can use the product instance.
             -     CANCELED: The product instance isn't any longer available to the customer.
             -     FAILED: The product instance couldn't be delivered successfully and has never been available to the customer.
             -     AWAITING_ACTION: The product instance isn't yet available to the customer, because an external provider or the customer must take an action.
        - name: failure | type: FailureReason | description: Failure object. Only present for status `FAILED`. Describes why the product instance `FAILED`.  | read-only: true 
           - name: code | type: FailureReasonCode | description: Failure code.  
                 - enum:
                 -     DELIVERY_TIMEOUT: The product instance couldn't be created because the Resellers API timed out.
                 -     EXTERNAL_FAILURE: The product instance couldn't be created because an external process failed.
           - name: message | type: string | description: Failure message.  
        - name: _createdDate | type: Date | description: Date and time the product instance was created.  | read-only: true 
        - name: _updatedDate | type: Date | description: Date and time the product instance was last updated.  | read-only: true 
        - name: countryCode | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. Specifies where customers can claim vouchers that may come with the product. Contact the [Wix B2B sales team](mailto:bizdev@wix.com) to get more information about vouchers and supported locations.  | validation: format COUNTRY
        - name: expirationDate | type: Date | description: Date and time the product instance expires in `YYYY-MM-DDThh:mm:ss.sssZ` format. Used only for instances that don't auto renew at the end of the current billing cycle.  | read-only: true 
        - name: discountCode | type: string | description: Discount code indicating that the reseller provisioned the product instance during a sale. Wix doesn't guarantee that a discount code reduces the price between Wix and the reseller, even when it's valid. Contact the [Wix B2B sales team](mailto:bizdev@wix.com) for more information.  Max: 25 characters  | validation: maxLength 25
        - name: referenceProductInstanceId | type: string | description: GUID of a different product instance that you can use to offer your customers time-limited free access to an additional product or service. For example, Wix offers a 1-year free domain registration to all customers who purchase a Premium plan. The referenced product instance must have either status `"PENDING"` or `"ACTIVE"`. You can use each product instance only a single time as reference instance.  | validation: format GUID
     - name: _createdDate | type: Date | description: Date and time the package was created.  | read-only: true 
     - name: _updatedDate | type: Date | description: Date and time the package was last updated.  | read-only: true 


```

### Examples

### Update a package's external ID with an API key
```javascript
import { createClient, ApiKeyStrategy } from "@wix/sdk";
import { packages } from "@wix/packages";

const wixClient = createClient({
 modules: { packages },
 auth: ApiKeyStrategy({
    apiKey: "MY-API-KEY",
  }),
});

async function updatePackageExternalId(identifiers) {
  const response = await packages.updatePackageExternalId(identifiers);
}

```

### updatePackageExternalId (self-managed)
Self-managed SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { packages } from '@wix/packages';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { packages },
  // Include the auth strategy and host as relevant
});


async function updatePackageExternalId(identifiers) {
  const response = await myWixClient.packages.updatePackageExternalId(identifiers);
};
```

---