Provides a list of web categories.

<!-- No XML Request. -->

<categories>
    <category uri="/setup/web_categories/x/" id="x" full_render="false">
        <name>[string]</name>
        <list_order>[int]</list_order>
        <type>[int]</type>
        <depth>[int]</depth>
        <parent>
            <category> <!-- summarized, full_render=false-->
                ....
            </category>
            [...]
        </parent>
    </category>
    [...]
</categories>

Create a WEB Category

<category>
    <name>[string: max_len(1023)]</name>
    <parent>
        <category id="[integer]" />
    </parent>
    <list_order>[integer]</list_order>
</category>

<category uri="/setup/web_categories/x/" id="x">
    <!-- see GET /setup/web_categories/x/ response -->
</category>

Provides the details of a web category.

By default a category will render up to the first 10 assigned products.
To page on the full list see GET /setup/web_categories/x/products/ .
You can also omit the product details with the hide_products filter.

<!-- No XML Request. -->

<category uri="/setup/web_categories/x/" id="x">
    <name>[string]</name>
    <list_order>[integer]</list_order>
    <type>web</type>
    <depth>[integer]</depth>
    <parent>
        <category uri="/setup/web_categories/y/" id="y">
            <name>[string]</name>
            <list_order>[integer]</list_order>
            <type>web</type>
            <depth>[integer]</depth>
        </category>
    </parent>
    <children>
        <category uri="/setup/web_categories/z/" id="z"/>
    </children>
    <category_products total_count="[integer]">
        <category_product uri="/setup/web_categories/x/products/b/" id="b">
            <product uri="/products/b/" id="b" full_render="false">
                <code>[string]</code>
                <flags>
                    <master_model>[boolean]</master_model>
                </flags>
                <description short="">[string]</description>
                <product_photos>
                    <product_photo uri="/products/b/product_photos/e/" id="e" />
                </product_photos>
            </product>
        </category_product>
    </category_products>
</category>

Modify the details of a web category.

<category>
    <parent>
        <category id="[integer]" />
    </parent>
    <name>[string: max_len(1023)]</name>
    <list_order>[integer]</list_order>
</category>

<category uri="/setup/web_categories/x/" id="x">
    <!-- see GET /setup/web_categories/x/ response -->
</category>

Delete a WEB category and its children categories. Children products become
uncategorized.

<!-- No XML Request -->

<!-- No XML Response -->

Provides the product list of a web category.

<!-- No XML Request -->

<category_products total_count="[integer]">
    <category_product uri="/setup/web_categories/x/products/b/" id="b">
        <product uri="/products/b/" id="b" full_render="false">
            <code>[string]</code>
            <flags>
                <master_model>[boolean]</master_model>
            </flags>
            <description short="[string]">[string]</description>
            <product_photos>
                <product_photo uri="/products/b/product_photos/r/" id="r" />
            </product_photos>
        </product>
    </category_product>
</category_products>

Add a product to a WEB category.

<category_product>
    <product id="[integer]">
</category_product>

<category_product uri="/setup/web_categories/x/products/y/" id="y">
    <!-- see GET /setup/web_categories/x/products/y/ response -->
</category_product>

Returns a category product.

<!-- No XML Request -->

<category_product uri="/setup/web_categories/x/products/y/" id="y">
    <product uri="/products/y/" id="y">
        <!-- see GET /products/X/ response for details -->
    </product>
</category_product>

Remove a product from a WEB category.

<!-- No XML Request -->

<!-- No XML Response -->

Provides the parent-most WEB category, which contains uncategorized products
and children categories. Note: Depth is 0 for a primary category, 1 for a
secondary category, and 2 for a tertiary category.

By default this category will render up to the first 10 uncategorized products.
To page on the full list see GET /setup/web_categories/root/products/ .
You can also omit the product details with the hide_products filter.

<!-- No XML Request -->

<!-- see GET /setup/web_categories/x/ response

NOTE: There is a difference in the way the category and category_products tags are rendered:

<category uri="/setup/web_categories/root/">
<category_product uri="/setup/web_categories/root/products/P/">
-->

Lists uncategorized products.

<!-- No XML Request -->

<!-- see GET /setup/web_categories/x/products/ response

NOTE: There is a difference in the way the category product tag is rendered:

<category_product uri="/setup/web_categories/root/products/P/">
-->

Return an uncategorized product.

<!-- No XML Request -->

<!-- see GET /setup/web_categories/x/products/y/ response

NOTE: There is a difference in the way the category product tag is rendered:

<category_product uri="/setup/web_categories/root/products/P/">
-->