Merge pull request #951 from magento/kh_2.2_catalog_rest_57116

adding a list of category custom attributes

Author: keharper

guides/v2.0/rest/catalog-notes.md

@@ -12,7 +12,38 @@ github_link: rest/catalog-notes.md
 
 ## POST V1/categories
 
-When you create a {% glossarytooltip 50e49338-1e6c-4473-8527-9e401d67ea2b %}category{% endglossarytooltip %} from Admin, you have the option to configure display and {% glossarytooltip ae8f7f2b-ddfb-41ed-bec3-bed191406fdd %}search engine optimization{% endglossarytooltip %} settings. The `POST V1/categories` {% glossarytooltip 786086f2-622b-4007-97fe-2c19e5283035 %}API{% endglossarytooltip %} does not accept any of these parameters directly, but they can be defined as custom attributes, as shown in the following example.
+When you create a {% glossarytooltip 50e49338-1e6c-4473-8527-9e401d67ea2b %}category{% endglossarytooltip %} from Admin, you have the option to configure display and {% glossarytooltip ae8f7f2b-ddfb-41ed-bec3-bed191406fdd %}search engine optimization{% endglossarytooltip %} settings. To configure these settings using REST, you can specify the following parameters as `attribute_code` values:
+
+```
+all_children
+children
+children_count
+custom_apply_to_products
+custom_design
+custom_design_from
+custom_design_to
+custom_layout_update
+custom_use_parent_settings
+default_sort_by
+description
+display_mode
+filter_price_range
+image
+is_anchor
+landing_page
+meta_description
+meta_keywords
+meta_title
+page_layout
+path
+path_in_store
+url_key
+url_path
+```
+
+Third-party modules may define other custom attributes.
+
+The following example uses the `POST V1/categories` call to assign four custom attributes to the "My New Category" category.
 
 {% highlight json %}