> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/release-notes/2023.md).

# 2023

All 2023 release notes in one place, newest first. Historical entries use their original publication dates and remain grouped by their release year.

{% updates format="full" %}
{% update date="2023-11-07" %}

## November 2023

### Integration Features & Updates

#### New Integrations

**TikTok Shop US** and **TikTok Shop UK** are now available on Order Desk!

TikTok Shop can be used to sell your products directly to a highly engaged audience on social media, and using it with Order Desk will allow you to add another sales channel to your existing workflow. We’ve been working on establishing this connection for literal years, and we can’t wait to see how you utilize this!

Please note: if you don’t already have an active TikTok Shop account you can create one through the [TikTok Shop Seller Center](https://seller-us-accounts.tiktok.com/account/register).

To learn more about using TikTok Shop with Order Desk, [click here](https://www.orderdesk.com/integrations/tiktok-shop/).

#### App Updates

* Use the **BCC** field in Order Desk email templates to include additional recipients. [Details here](https://help.orderdesk.com/article/255-work-with-email-templates#edit).

#### Shopping Carts

Additional **order level options** that can be set as checkout data or order metadata for:

* Logicbroker: Use **Carrier** and **ShipMethod** to override the carrier and service level for your orders. [Details Here](https://help.orderdesk.com/article/824-logicbroker-integration#submit).
* Dsco Supplier: Use SSCC to set the SSCC Barcode and ShipWeight to set shipping weight. [Details Here](https://help.orderdesk.com/article/641-dsco-supplier-integration#submit).

#### Print on Demand

Additional **order level options** that can be set as checkout data or order metadata for:

* SwiftPOD: Use **InternalNotes** to pass internal notes to SwiftPOD. [Details Here](https://help.orderdesk.com/article/729-swiftpod-integration#custom).
* Casestry: Use **autoscale** to specify whether or not Casestry should automatically scale the artwork on your item. [Details Here](https://help.orderdesk.com/article/416-casestry-integration#submit).

Additional **item level options** that can be set as variations or item metadata for:

* Custom Gateway: **print\_location\_x** now allows for 7 options (e.g. print\_location\_1, print\_location\_2, etc.). [Details Here](https://help.orderdesk.com/article/399-custom-gateway#custom-details).
* Print Geek Kornit X: **print\_location\_x** now allows for 7 options (e.g. print\_location\_1, print\_location\_2, etc.). [Details Here](https://help.orderdesk.com/article/674-print-geek-kornit-x-integration#custom-details).
* Who’s On Your Case: **print\_location\_x** now allows for 7 options (e.g. print\_location\_1, print\_location\_2, etc.). [Details Here](https://help.orderdesk.com/article/572-whos-on-your-case-integration#custom-details).
* Taylor: **Print\_sku**, **print\_url\_x** (Up to 5), **print\_process**, **asset\_type**, and **mime\_type** fields are now available. [Details Here](https://help.orderdesk.com/article/838-taylor-integration#submit).

#### Fulfillment

Additional **order level options** that can be set as checkout data or order metadata for:

* Avectous: Use **OrderNumber** and **ChannelOrderNumber** to set the order number and channel order number. [Details Here](https://help.orderdesk.com/article/787-avectous-integration#custom).
* OIA Global: Use **Lot** to set a lot number. [Details Here](https://help.orderdesk.com/article/206-oia-global#submit).

Additional **item level options** that can be set as variations or item metadata for:

* Stuller: Engraving options are now available via Stuller. [Details Here](https://help.orderdesk.com/article/356-stuller#custom).

#### Shipping

Additional **order level options** that can be set as checkout data or order metadata for:

* Shipstation: Use **ShipByDate** to set latest ship date for your order. [Details Here](https://help.orderdesk.com/article/293-shipstation-new#detail).
* eShipper: Use Reference to set reference data. Default is Source ID. [Details Here](https://help.orderdesk.com/article/853-eshipper-integration#item-level).
* ShipHero: **CustomerAccountID** can be used to override the Customer Account ID set in the integration settings. [Details Here](https://help.orderdesk.com/article/583-shiphero-order-export-integration#order-level-details).

See you next month,

*Patricia and The Order Desk Team*
{% endupdate %}

{% update date="2023-10-03" %}

## October 2023

### Integration Features & Updates

#### New Integrations

Apparel Magic is a print on demand fulfillment company with a focus on the fashion industry. Learn more about the features of this integration [here](https://www.orderdesk.com/integrations/apparelmagic/).

MT3 offers print on demand services for tech items (e.g. phone cases) with over 150 models available. Learn more about the features of this integration [here](https://www.orderdesk.com/integrations/mt3/).

#### Shopping Carts

**SPS Commerce**: In the Invoice Settings, use the Seller Currency field to pass what currency the seller will be using via your invoices. Payment Terms can also be used to pass any terms of payment via invoices. [Details Here](https://help.orderdesk.com/article/428-sps-commerce-integration#settings).

#### Print on Demand

Additional **order level options** that can be set as order metadata or checkout data for:

* SwiftPOD: Use the **PackingSlip** field to pass the packing slip with your orders. [Details Here](https://help.orderdesk.com/article/729-swiftpod-integration#custom).

Additional **item level options** that can be set as variations or item metadata for:

* Lulu Xpress: Use **printable\_id** to pass the printable ID for the product. If this field is present, the other print fields (e.g. print\_url) aren’t necessary. [Details Here](https://help.orderdesk.com/article/814-lulu-xpress-integration#send).
* Alexander’s Print Advantage: Use **attribute\_key\_x** and **attribute\_value\_x** to set an attribute name a value. Up to 6. [Details Here](https://help.orderdesk.com/article/665-alexander-s-print-advantage-integration#custom-details-for-alexanders).
* Fujifilm: **print\_url\_x** can now be used for up to 12 options. [Details Here](https://help.orderdesk.com/article/467-fujifilm-integration#submit).
* AnywherePOD: Set the item source ID with the **item\_source\_id** field. [Details Here](https://help.orderdesk.com/article/847-anywherepod-integration#send).

**Candle Builders**: Gift Message is now available using the provided field in the Product Settings. [Details Here](https://help.orderdesk.com/article/720-candle-builders-integration#product).

**Printeers**: Use Max Inventory Level in the integration settings to set a maximum stock count for your items. [Details Here](https://help.orderdesk.com/article/657-printeers-integration#inventory).

#### Fulfillment

Additional **order level options** that can be set as order metadata or checkout data for:

* Hive Technologies: Use **batch\_tracking\_enabled** to set inventory tracking in a batch. [Details Here](https://help.orderdesk.com/article/807-hive-technologies-integration#submit).
* Cargowise: **WarehouseServiceLevel** to pass a service level override. [Details Here](https://help.orderdesk.com/article/789-cargowise-integration#sending-orders).

**Packiyo**: Sync Inventory is now available in the Packiyo integration settings. [Details Here](https://help.orderdesk.com/article/845-packiyo-integration#inventory).

**Ongoing WMS**: Update Catalog is now available to pass inventory updates to Ongoing WMS. [Details Here](https://help.orderdesk.com/article/633-ongoing-wms-integration#advanced).

**Zenventory**: Use the Auto Check For Shipments setting to select whether or not you’d like Order Desk to check for shipments automatically. [Details Here](https://help.orderdesk.com/article/786-zenventory-integration#ship).

See you next month, *Patricia and The Order Desk Team*
{% endupdate %}

{% update date="2023-09-05" %}

## September 2023

Here is a look at some of the updates and new features from Order Desk this month.

### New integration

Visual Ink is a print on demand fulfillment company. Learn more about the features of this integration [here](https://www.orderdesk.com/integrations/visual-ink/).

### New integration settings available for:

* Finale Inventory: Use **Auto Complete Orders** to mark orders as complete when they are successfully imported at Finale and **Auto Ship Orders** to mark orders as shipped before order completion. [Details Here](https://help.orderdesk.com/article/849-finale-inventory-integration).
* Logiwa: Use **Automatically Send Imported Orders** **to Logiwa** to send all orders that are imported to your Order Desk store to Logiwa for fulfillment. [Details Here](https://help.orderdesk.com/article/625-logiwa-integration#settings).
* Amazon FBA: Use **Fetch Confirmed Shipments Only** to only pull in shipments for packages that have been scanned. [Details Here](https://help.orderdesk.com/article/311-fulfillment-by-amazon-fba-settings).
* Hive: **Update Catalog** can be used to update the inventory catalog in Hive using the items created by Order Desk (in the case that an inventory item doesn’t exist). If the inventory item *does* exist, Order Desk will update it. To delete items using this tool, set **hivetechnologies\_delete** as item metadata on your inventory item to flag it for deletion. [Details Here](https://help.orderdesk.com/article/807-hive-technologies-integration).
* Etsy: Use the **Country Filter** to only import orders from specific countries. [Details Here](https://help.orderdesk.com/article/106-etsy-integration#settings).

### Print on Demand

Additional **item level options** that can be set as variations or item metadata for:

* Catalyst Fabric Solutions: Use the Repeats field to pass the number of repeating patterns for Fabric By the Yard products. [Details Here](https://help.orderdesk.com/article/170-catalyst-fabric-solutions#submit).
* CustomCat: Use **print\_design\_id** to pass the print design id for your item (if applicable). [Details Here](https://help.orderdesk.com/article/367-customcat#submit).

### Fulfillment

Additional **order level options** that can be set as checkout data or order metadata for:

* Veracore: Use ShippingAccountCompany, ShippingAccountCountry, and ShippingAccountEmail to pass shipping account information. [Details Here](https://help.orderdesk.com/article/12-veracore#order-level).
  {% endupdate %}

{% update date="2023-08-01" %}

## August 2023

August is here and so are the most recent release notes! Here is a look at some of the updates and new features from Order Desk this month.

### New Integrations

**Cart:** [Shein](https://help.orderdesk.com/article/848-shein-integration)

### App Updates

Specific inventory items can now be exported using the search function in your Inventory Items page. By adding search terms to the fields and clicking **Export**, only items in your inventory that meet the criteria will be exported. [Details Here](https://help.orderdesk.com/article/212-quick-start-orders-and-inventory#inventory).

![](https://www.orderdesk.com/wp-content/uploads/2023/08/Untitled-3-1024x129.png)

### Integration Features & Updates

#### Print on Demand

Additional **order level options** that can be set as checkout data or order metadata for:

* Dream Junction: Print fields now allow up to 7 options (e.g. **print\_url\_ 1**, **print\_url\_ 2**, etc.). [Details Here](https://help.orderdesk.com/article/252-dream-junction-integration#custom-details-for-dream-junction).
* Turbine: Print fields now allow up to 7 options (e.g. **print\_url\_ 1**, **print\_url\_ 2**, etc.). Use decoration\_type to set decoration type with a value of either **dtf** or **dtg.** Details Here.

Additional **item level options** that can be set as variations or item metadata for:

* Print Geek Original: Use text\_product\_id to set contextual product information (e.g. a neck label identifier). [Details Here](https://help.orderdesk.com/article/844-print-geek-original#custom-details).

#### Fulfillment

Additional **order level options** that can be set as checkout data or order metadata for:

* Logiwa: Use **Depositor** to set the depositor information. **OrderRouting** can now be used to set order routing. [Details Here](https://help.orderdesk.com/article/625-logiwa-integration#custom-order-details).
* Fulfillrite: Use **ShippingMethod** to set he shipping method for your order. If this field is not present, the shipping method will be set using the integration settings. [Details Here](https://help.orderdesk.com/article/109-fulfillrite#order-level-details).

#### Productivity

Additional **order level options th**at can be set as checkout data or order metadata for:

* AfterShip: Use **AfterShipOrderID** to set the order number. If no order number is set, the Order Source ID will be used. [Details Here](https://help.orderdesk.com/article/650-aftership-integration).
  {% endupdate %}

{% update date="2023-07-03" %}

## July 2023

Happy July! Here is a look at some of the updates and new features from Order Desk this month.

![](https://www.orderdesk.com/wp-content/uploads/2023/07/8d44983438f8728605fc1ae4775303b3.gif)

### Integration Features & Updates

#### Shopping Carts

New **integration settings** available for:

* Shopify: Use Inventory Location Filter to filter which order items are imported to Order Desk. [Details Here](https://help.orderdesk.com/article/7-shopify-integration#settings).

#### Fulfillment

New **integration settings** available for:

* Logiwa: Use **Default Order Type** to set the default order type for your orders. [Details Here](https://help.orderdesk.com/article/625-logiwa-integration#setup).
* 3PL Central: Use **Skip Carrier Prefetch** to skip available carrier lookup when orders are sent. [Details Here](https://help.orderdesk.com/article/8-3pl-central-integration#settings).

Additional **order level options** that can be set as checkout data or order metadata for:

* Mintsoft: Use **Currency** if you need to set an a currency value on a per order basis. [Details Here](https://help.orderdesk.com/article/445-mintsoft-integration#ship).
* Logiwa: Use **driver** field to pass driver data to Logiwa. The **Carrier** and **ShipmentMethod** fields can be used to override the carrier and shipment methods respectively. [Details Here](https://help.orderdesk.com/article/625-logiwa-integration#custom-order-details).

#### Shipping

New **integration settings** available for:

* ShipWorks: Use **Order Field Filter** to filter which orders are sent to ShipWorks. [Details Here](https://help.orderdesk.com/article/119-shipworks#setup).

Additional **order level options** that can be set as checkout data or order metadata for:

* Easypost: Use **hs\_tariff** to set harmonized tariff codes and **easypost\_descriptions** for setting item descriptions which need to be passed onto EasyPost. [Details Here](https://help.orderdesk.com/article/74-easypost-integration#tax).

### New Integrations

**Fulfillment:** [Packiyo](https://www.orderdesk.com/integrations/packiyo/)

**Productivity:** [AnywherePOD](https://www.orderdesk.com/integrations/anywherepod/)

See you next month,

*Patricia and The Order Desk Team*
{% endupdate %}

{% update date="2023-05-03" %}

## May 2023

In this newsletter:

* New integrations
* Spotlight On…SMTP
* This GIF:

![](https://www.orderdesk.com/wp-content/uploads/2023/05/b48b723ed272cde359d3cc6e86e7eb4b.gif)

​

### Integration Features & Updates

#### Shopping Carts

Additional **order level options** that can be set as checkout data or order metadata for:

* Etsy: Use the **note\_to\_buyer** field to send a customer note as checkout data or a metadata field, which will be sent over to Etsy when Order Desk checks for shipment information. [Details Here](https://help.orderdesk.com/article/106-etsy-integration#note).

#### Print on Demand

Additional **item level options** that can be set as variations or item metadata for:

* White Label MFG: If requested by White Label MFG, use the **drop\_shipped** field to pass data. [Details Here](https://help.orderdesk.com/article/603-white-label-mfg-integration#custom-details-for-white-label-mfg).

​

### New Integrations

**Fulfillment:**[ FreightPOP](https://help.orderdesk.com/article/828-freightpop-integration)**​ Shopping Carts:** [Big Cartel](https://help.orderdesk.com/article/831-big-cartel-integration)​

​

### Spotlight on…SMTP

First off, if you’re not sure what SMTP is or how it works, feel free to take a little journey over to the [blog post](https://www.orderdesk.com/using-order-desk/what-is-smtp-and-why-does-it-matter/) I wrote explaining the basics!

Now that you’ve done that…here are some updates to how we are handling email in the Order Desk app. 😊

If you use Order Desk to send emails, you may have received email communication last week letting you know about some changes to that function in the app.

To summarize, we were informed by the email server that Order Desk uses that they would no longer be supporting the use of email addresses that have not been previously approved. This means that email sent out from Order Desk on your behalf can no longer be sent white-labeled, or having it look like you sent it.

Not to worry, though. We made some changes to the app to help you continue sending emails in the way you prefer for your unique business. Now you have three options available to you:

* Continue sending emails using our server, in which case your email addresses will appear like this:

![](https://www.orderdesk.com/wp-content/uploads/2023/05/image-2.png)

* Use the SMTP server of your choosing:

![](https://www.orderdesk.com/wp-content/uploads/2023/05/Store-Settings-Email-2023-05-01-15-08-58.png)

* Use our native tool to connect with Google servers:

![](https://www.orderdesk.com/wp-content/uploads/2023/05/Store-Settings-Email-2023-05-01-15-10-00.png)

Each of the SMTP options can be tested using the tools beneath the input fields for your credentials.

More instructions on how to set up these options can be found [in this guide](https://help.orderdesk.com/article/28-send-email-from-order-desk).

​

### Switching Gears

Since you learned a bit about how email is sent in this newsletter, I would love to hear about the *weirdest* email you’ve ever received! Let me know at <support@orderdesk.com>.

When email first became common, I used to get *really* scared reading chain emails. Remember those? “Forward this to 13 people or a ghost will visit you in your home and eat you!” Bear in mind, I was probably 8 years old so I thought it was perfectly logical outcome. 👻

See you next month, ​*Patricia and The Order Desk Team*
{% endupdate %}

{% update date="2023-04-05" %}

## April 2023

In this month’s newsletter:

* Not one single April Fool’s Day joke (I promise!)
* Lots of Print on Demand item level option updates
* A few new integrations 😋
* Spotlight On…Recovering Your Account Access

With that said, let the newsletter commence!

![](https://www.orderdesk.com/wp-content/uploads/2023/04/d1030c1697ce9d0972c6ef10d4af9b2f.gif)

### Integration Features & Updates

#### Print on Demand

Additional **item level options** that can be set as variations or item metadata for:

* Acrylic Idea Factory: The **print\_url** field now accepts PDF or JPG (up to 2). [Details Here](https://help.orderdesk.com/article/597-acrylic-idea-factory-integration#send).
* Prodigi: The **print\_location** field now accepts up to 5 options. Must correspond with the matching print\_url\_x (e.g. print\_url\_1 and print\_location\_1). [Details Here](https://help.orderdesk.com/article/757-prodigi-integration#send).
* Monster Digital: If an order is a reprint, each item must have the correct data in the **reprint\_reason** and **reprint\_images** fields. [Details Here](https://help.orderdesk.com/article/639-monster-digital-integration#custom-details).
* Cloudprinter: Up to 6 options now accepted for **print\_url** and **print\_type**. [Details Here](https://help.orderdesk.com/article/735-cloudprinter-integration#send).

Additional **order level options** that can be set as checkout data or order metadata for:

* Spoke Custom: Use **spokecustom\_key** to pass an API key that will override the default stored in Order Desk and **spokecustom\_customer\_name** to pass an API name that will override the default stored in Order Desk. [Details Here](https://help.orderdesk.com/article/407-spoke-custom-integration#submit).

Printeers now has **Sync Inventory** options available in the integration settings. [Details Here](https://help.orderdesk.com/article/657-printeers-integration#inventory).

#### Fulfillment

Additional **item level options** that can be set as variations or item metadata for:

* Dubow: Use **RetailPrice** to pass the retail price of an individual item and **HarmonizedCode** to pass the HS Code for the item. [Details Here](https://help.orderdesk.com/article/155-dubow#submit).

### New Integrations

**Cart:** [LogicBroker](https://help.orderdesk.com/article/824-logicbroker-integration)​

**Fulfillment:** [Fulfillify](https://help.orderdesk.com/article/830-fulfillify-integration)​

**Print on Demand:** [Merchize](https://help.orderdesk.com/article/822-merchize-integration), [ShirtplatformAPI](https://help.orderdesk.com/article/829-shirtplatform-api)​

### Spotlight on…Recovering Your Account Access

Did you forget your password?

![](https://www.orderdesk.com/wp-content/uploads/2023/04/31536e302604ec0c88e42d05a2595ae4.gif)

As an avid forgetter of passwords, I know the woe of trying to log into a website and realizing you didn’t use one of your 3 trusty passwords.

We all have just 3 passwords, right?

#### Next Steps

Now that you’ve admitted to yourself that the password is lost in the deep recesses of your brain, you’ll need to click ‘**Forgot Password?**’ on the [Order Desk login page](https://app.orderdesk.me/login). After you’ve done that, a **Send Password Reset Instructions** tool will almost magically appear, where you can then put the email you use for your account in the **Email Address** field and click **Submit**:

![](https://www.orderdesk.com/wp-content/uploads/2023/04/1f103ed9f0ca64e97f31d8d3f49a30b6.gif)

From there, we’ll send you an email that will allow you to reset your password!

#### What if you can’t find the email in your inbox?

No problem! Sometimes password reset emails end up in the spam inbox, so check there first if it doesn’t appear in your main inbox after a few minutes.

If you still can’t find the email, there is a chance that the email address you provided might not be associated with your Order Desk account. While that sounds like a strange notion, many people use multiple emails for their business and on occasion this can lead to a bit of account confusion.

If that happens, reach out to us at <support@orderdesk.com> with your store name! Our support team will help you get back to managing your store in no time. 😊

### Switching Gears

That’s all for now!

Since the dreaded April Fool’s Day has now passed, hit us up at <support@orderdesk.com> to tell us: what’s the worst prank you’ve ever pulled? Don’t be shy, we won’t judge.

I once created an elaborate story that my parents were going to surprise my older sister with a sports car for her 16th birthday.

…it didn’t go well.

See you next month, ​*Patricia and The Order Desk Team*
{% endupdate %}

{% update date="2023-03-07" %}

## March 2023

Greetings from Puerto Vallarta, Mexico!

![Photo by Dan Valenzuela](https://embed.filekitcdn.com/e/dDYhGhYfNV9GZjqkyJS3sj/3ZfhD5Kn87dXFkKem7uC4r?w=800\&fit=max)

Photo by Dan Valenzuela

Order Desk is finally having a company retreat for the first time since before the global pandemic. We’ve hired 14 people since then (tripling our company in size!) and the majority of us have never even met in person!

Before I can put my toes in the sand, I’m going to loop you in on our updates!

### Integration Features & Updates

#### Shopping Carts

**SPS Commerce:** Custom **Invoice Settings** are now available. [Details Here](https://help.orderdesk.com/article/428-sps-commerce-integration#settings).

**Notonthehighstreet: Country Filter** can now be used to only import orders from specific countries. [Details Here](https://help.orderdesk.com/article/733-notonthehighstreet-integration#settings).

**Amazon Marketplace: Country Filter** can now be used to only import orders from specific countries. [Details Here](https://help.orderdesk.com/article/50-amazon-marketplace-integration#settings).

#### Print on Demand

Additional **item level options** that can be set as variations or item metadata for:

* Tribe Socks: If requested by Tribe Socks, use **design** and **designer\_comment** to set design type and comment. [Details Here.](https://help.orderdesk.com/article/561-tribe-socks#submit)

#### Fulfillment

**Hive:** If a product does not exist at the time of order submission, Order Desk can create a product prior to sending the order to Hive. [Details Here.](https://help.orderdesk.com/article/807-hive-technologies-integration#submit)

### New Integrations

**Print On Demand:** [ArtToFrames](https://help.orderdesk.com/article/821-arttoframes-integration)

### Spotlight on…Rule Sequences

If you find that your rules aren’t running as smoothly as you’d like, one of the first things to examine is your [rule sequences](https://help.orderdesk.com/article/396-how-to-work-with-rules#order).

Rules run in the exact order in which they appear under each event. Taking a look at the screenshot below, you can see a rule to add a free gift to orders within the US and a rule that changes item prices are running *after* orders are submitted to Gelato for fulfillment:

![](https://embed.filekitcdn.com/e/dDYhGhYfNV9GZjqkyJS3sj/wBVDpeZX4aMDFQyjA3x8SC?w=800\&fit=max)

With this set up, orders are going to be sent for fulfillment without the necessary changes rules one and two create. That means customers missing out on their free gift item or your records are not reflecting additional costs!

The good news is that there is an easy fix! Simply drag and drop the rules into the correct order:

![](https://embed.filekitcdn.com/e/dDYhGhYfNV9GZjqkyJS3sj/tpWh66paaq3DxatF1jPDeD?w=800\&fit=max)

If you’re ever unsure about the sequence you’ve created for your rules, give us a shout and someone on our support team will take a look!

### Switching Gears

I’m off to find elote and margaritas, but if you’re seeking assistance from us or just want to say “¡Hola!” you can send an email over to <support@orderdesk.com>. We’ve still got your back even while we’re team building in the sun. 😊

Adiós, *Patricia and The Order Desk Team*
{% endupdate %}
{% endupdates %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.orderdesk.com/release-notes/2023.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.