# Other API Operations

There are a number of different things you can do with our APIs. This page describes some of those operations.

## Recommendations

It is possible to get recommendations for other products that a customer might like. You can use this on the product details page.

{% openapi src="/files/6LLr34K6t6WDdJldj1t5" path="/roots/menu\_api/v1/stores/{store\_id}/products/{product\_id}/recommendations" method="get" %}
[menu\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2F7nwg4iQiePZMLsT6QD6o%2Fmenu_api.json?alt=media\&token=edd00d1a-604f-48ed-bc34-c7666a40a3c3)
{% endopenapi %}

## Updating Menus

We offer a number of endpoints that enable you to update your store menus.

### Custom Product Type Labels

These endpoints will enable you to CRUD custom product type labels

{% openapi src="/files/Fr5vK2GLfpmKhozqZMYO" path="/roots/store\_operations\_api/v1/custom\_labels" method="get" %}
[store\_operations\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2F4Vp1C2vbhnOy9YAaKGQQ%2Fstore_operations_api.json?alt=media\&token=91ff188a-1f23-4840-9319-aca55c8684a2)
{% endopenapi %}

{% openapi src="/files/Fr5vK2GLfpmKhozqZMYO" path="/roots/store\_operations\_api/v1/custom\_labels/modify" method="put" %}
[store\_operations\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2F4Vp1C2vbhnOy9YAaKGQQ%2Fstore_operations_api.json?alt=media\&token=91ff188a-1f23-4840-9319-aca55c8684a2)
{% endopenapi %}

{% openapi src="/files/Fr5vK2GLfpmKhozqZMYO" path="/roots/store\_operations\_api/v1/custom\_labels/remove" method="delete" %}
[store\_operations\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2F4Vp1C2vbhnOy9YAaKGQQ%2Fstore_operations_api.json?alt=media\&token=91ff188a-1f23-4840-9319-aca55c8684a2)
{% endopenapi %}

### Menu Products

These endpoint will enable you to update photos and to bulk edit menu products

{% openapi src="/files/Fr5vK2GLfpmKhozqZMYO" path="/roots/store\_operations\_api/v1/menu\_products/{menu\_product\_id}/photos" method="patch" %}
[store\_operations\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2F4Vp1C2vbhnOy9YAaKGQQ%2Fstore_operations_api.json?alt=media\&token=91ff188a-1f23-4840-9319-aca55c8684a2)
{% endopenapi %}

{% openapi src="/files/Fr5vK2GLfpmKhozqZMYO" path="/roots/store\_operations\_api/v1/menu\_products/photos\_by\_state" method="patch" %}
[store\_operations\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2F4Vp1C2vbhnOy9YAaKGQQ%2Fstore_operations_api.json?alt=media\&token=91ff188a-1f23-4840-9319-aca55c8684a2)
{% endopenapi %}

{% openapi src="/files/Fr5vK2GLfpmKhozqZMYO" path="/roots/store\_operations\_api/v1/menu\_products/bulk" method="patch" %}
[store\_operations\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2F4Vp1C2vbhnOy9YAaKGQQ%2Fstore_operations_api.json?alt=media\&token=91ff188a-1f23-4840-9319-aca55c8684a2)
{% endopenapi %}

## Retrieving Carts

The following API will enable you to retrieve all orders for a store. Note that this is an expensive call, so you should scope it to fairly narrow date range.

{% openapi src="/files/Fr5vK2GLfpmKhozqZMYO" path="/roots/store\_operations\_api/v1/carts" method="get" %}
[store\_operations\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2F4Vp1C2vbhnOy9YAaKGQQ%2Fstore_operations_api.json?alt=media\&token=91ff188a-1f23-4840-9319-aca55c8684a2)
{% endopenapi %}

## External User Operations

If you are using Cognito for authentication, there are a number of different operations you can call to get the status of or to set information for these users.

### User Operations

{% openapi src="/files/k0zovPh6HAWWN7s7HX46" path="/roots/external\_user\_api/v1/user" method="get" %}
[external\_user\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2FQfChEkZgWIGyWbKYuFyw%2Fexternal_user_api.json?alt=media\&token=ce4ce61d-1af3-43f3-838c-5b9806e17eae)
{% endopenapi %}

{% openapi src="/files/k0zovPh6HAWWN7s7HX46" path="/roots/external\_user\_api/v1/user" method="patch" %}
[external\_user\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2FQfChEkZgWIGyWbKYuFyw%2Fexternal_user_api.json?alt=media\&token=ce4ce61d-1af3-43f3-838c-5b9806e17eae)
{% endopenapi %}

### Product Reviews

{% openapi src="/files/k0zovPh6HAWWN7s7HX46" path="/roots/external\_user\_api/v1/product\_reviews/{product\_review\_id}/product\_review\_reports" method="post" %}
[external\_user\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2FQfChEkZgWIGyWbKYuFyw%2Fexternal_user_api.json?alt=media\&token=ce4ce61d-1af3-43f3-838c-5b9806e17eae)
{% endopenapi %}

{% openapi src="/files/k0zovPh6HAWWN7s7HX46" path="/roots/external\_user\_api/v1/product\_reviews/{product\_review\_id}/product\_review\_upvotes" method="post" %}
[external\_user\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2FQfChEkZgWIGyWbKYuFyw%2Fexternal_user_api.json?alt=media\&token=ce4ce61d-1af3-43f3-838c-5b9806e17eae)
{% endopenapi %}

### User Product Favorites

{% openapi src="/files/k0zovPh6HAWWN7s7HX46" path="/roots/external\_user\_api/v1/users/product\_favorites" method="get" %}
[external\_user\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2FQfChEkZgWIGyWbKYuFyw%2Fexternal_user_api.json?alt=media\&token=ce4ce61d-1af3-43f3-838c-5b9806e17eae)
{% endopenapi %}

{% openapi src="/files/k0zovPh6HAWWN7s7HX46" path="/roots/external\_user\_api/v1/users/product\_favorites" method="post" %}
[external\_user\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2FQfChEkZgWIGyWbKYuFyw%2Fexternal_user_api.json?alt=media\&token=ce4ce61d-1af3-43f3-838c-5b9806e17eae)
{% endopenapi %}

{% openapi src="/files/k0zovPh6HAWWN7s7HX46" path="/roots/external\_user\_api/v1/users/product\_favorites/{product\_id}" method="delete" %}
[external\_user\_api.json](https://338810739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS4Bq28Gj1vy78MuGEwRE%2Fuploads%2FQfChEkZgWIGyWbKYuFyw%2Fexternal_user_api.json?alt=media\&token=ce4ce61d-1af3-43f3-838c-5b9806e17eae)
{% endopenapi %}


---

# Agent Instructions: 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:

```
GET https://docs.iheartjane.com/jane-docs/implementing-roots/other-api-operations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.