sfcc-data-api.json

{"basePath":"/s/-/dw/data/20.8","consumes":["application/json","text/xml","application/xml"],"definitions":{"ab_test":{"description":"The id of the A/B Test","properties":{"customer_groups":{"description":"The list of customer group ids assigned to the A/B Test. Defaults to 'Everyone' if not specified on create","items":{"type":"string"},"type":"array"},"description":{"description":"The optional description of the A/B Test","maxLength":4000,"type":"string"},"email_addresses":{"description":"The optional list of email addresses to send A/B Test results","items":{"type":"string"},"type":"array"},"enabled":{"description":"The flag representing the enabled state of the A/B Test. Defaults to false if not specified on create","type":"boolean"},"end_date":{"description":"The date that the A/B Test ends. Defaults to two weeks from creation date if both start and end dates are not specified on create","format":"date-time","type":"string"},"expiration_type":{"description":"The participant expiration type of the A/B Test. Defaults to 'never' if not specified on create","enum":["session","never"],"type":"string"},"id":{"description":"The id of the A/B Test","maxLength":40,"minLength":1,"type":"string"},"key_metric_id":{"description":"The key metric that is most important to the A/B Test, among the metrics collected. Defaults to 'Revenue' if not specified from test participant activity","maxLength":256,"type":"string"},"link":{"description":"The URL to get the A/B test. This is a computed attribute and cannot be modified","type":"string"},"paused":{"description":"The flag representing the paused state of the A/B Test. Defaults to false if not specified on create","type":"boolean"},"segment_count":{"description":"Segment count of A/B test. This is a computed attribute and cannot be modified","format":"int32","type":"integer"},"start_date":{"description":"The date that the A/B Test begins. Defaults to a week from creation date if both start and end dates are not specified on create","format":"date-time","type":"string"},"status":{"description":"Status of A/B test. This is a computed attribute and cannot be modified","enum":["ended","planned","running"],"type":"string"},"tags":{"description":"The optional list of tags to group similar A/B Tests so that they can be searched easily.","items":{"type":"string"},"type":"array"},"test_groups":{"description":"Test Groups created for an A/B Test. This is a read only attribute for now.","items":{"$ref":"#/definitions/ab_test_group"},"type":"array"},"test_segments":{"description":"Test Segments created for an A/B Test. This is a read only attribute for now","items":{"$ref":"#/definitions/ab_test_segment"},"type":"array"},"trigger":{"$ref":"#/definitions/ab_test_trigger","description":"The trigger that allows the test participant to be considered for an A/B Test"}}},"ab_test_group":{"description":"Document representing an A/B Test Group","properties":{"allocation":{"description":"Test Group percentage allocation","format":"int32","type":"integer"},"custom_experience":{"description":"Flag to determine if this Test Group is a customer experience","type":"boolean"},"description":{"description":"Test Group description","type":"string"},"id":{"description":"Test group id","type":"string"}}},"ab_test_search_result":{"description":"Request document containing a search response for A/B test","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"format":"int32","minimum":0,"type":"integer"},"expand":{"items":{"type":"string"},"type":"array"},"hits":{"description":"The search hits returned as an ordered list","items":{"$ref":"#/definitions/ab_test"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"ab_test_segment":{"description":"Document representing an A/B Test Segment","properties":{"allocation":{"description":"Test Group percentage allocation","format":"int32","type":"integer"},"custom_experience":{"description":"Flag to determine if this Test Group is a customer experience","type":"boolean"},"description":{"description":"Test Group description","maxLength":4000,"type":"string"},"id":{"description":"Test group id","maxLength":40,"minLength":1,"type":"string"},"link":{"description":"","type":"string"},"promotions":{"description":"Promotions which this segment has as experiences","items":{"type":"object"},"type":"array"},"slot_configs":{"description":"Slot configurations which this segment has as experiences","items":{"type":"object"},"type":"array"},"sorting_rules":{"description":"Sorting rules which this segment has as experiences","items":{"type":"object"},"type":"array"},"stats":{"$ref":"#/definitions/ab_test_segment_stats","description":"Statistics about the segment"}}},"ab_test_segment_stats":{"properties":{"adds_to_baskets":{"description":"","format":"int32","type":"integer"},"average_adds_per_basket":{"description":"","format":"double","type":"number"},"average_adds_per_basket_std_error":{"description":"","format":"double","type":"number"},"average_discount_amount":{"description":"","format":"double","type":"number"},"average_discount_amount_std_error":{"description":"","format":"double","type":"number"},"average_discount_amount_with_coupon":{"description":"","format":"double","type":"number"},"average_discount_amount_with_coupon_std_error":{"description":"","format":"double","type":"number"},"average_discount_amount_without_coupon":{"description":"The standard error for the average amount discounted for orders without using a coupon","format":"double","type":"number"},"average_discount_amount_without_coupon_std_error":{"description":"Units sold per hour","format":"double","type":"number"},"average_order_value":{"description":"","format":"double","type":"number"},"average_order_value_std_error":{"description":"","format":"double","type":"number"},"average_revenue_per_visit":{"description":"","format":"double","type":"number"},"average_revenue_per_visit_std_error":{"description":"","format":"double","type":"number"},"average_units_added_per_basket":{"description":"","format":"double","type":"number"},"average_units_adder_per_basket_std_error":{"description":"","format":"double","type":"number"},"average_units_per_order_std_error":{"description":"","format":"double","type":"number"},"average_units_per_visit":{"description":"","format":"double","type":"number"},"average_units_per_visit_std_error":{"description":"","format":"double","type":"number"},"basket_rate":{"description":"","format":"double","type":"number"},"baskets":{"description":"","format":"double","type":"number"},"checkout_rate":{"description":"","format":"double","type":"number"},"checkouts":{"description":"","format":"int32","type":"integer"},"conversion_rate":{"description":"","format":"double","type":"number"},"discount_amount_with_coupon":{"description":"","format":"double","type":"number"},"discount_amount_without_coupon":{"description":"","format":"double","type":"number"},"orders":{"description":"","format":"int32","type":"integer"},"revenue":{"description":"","format":"double","type":"number"},"total_discount_amount":{"description":"","format":"double","type":"number"},"units":{"description":"","format":"double","type":"number"},"units_added_to_baskets":{"description":"","format":"double","type":"number"},"visitors":{"description":"","format":"int32","type":"integer"},"visits":{"description":"","format":"int32","type":"integer"}}},"ab_test_trigger":{"description":"Document representing an A/B Test trigger.","properties":{"categories":{"description":"The list of categories. This is a modifiable attribute when trigger type is 'category_page_view' only","items":{"type":"string"},"type":"array"},"is_pipeline_based":{"description":"The flag indicating if the trigger is based on pipelines. This is a computed attribute and cannot be modified","type":"boolean"},"pipeline_calls":{"description":"The list of pipeline name and start node combinations (for example, Account-Show). This is a modifiable attribute when trigger type is 'pipeline_calls' only","items":{"type":"string"},"type":"array"},"trigger_type":{"description":"The type of the trigger. Defaults to 'immediately' if not specified on create","enum":["immediately","category_page_view","home_page_view","pipeline_call"],"type":"string"}}},"ab_tests":{"description":"Request document containing a set of ABTests","properties":{"count":{"format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/ab_test"},"type":"array"},"expand":{"items":{"type":"string"},"type":"array"},"next":{"type":"string"},"previous":{"type":"string"},"select":{"type":"string"},"start":{"format":"int32","minimum":0,"type":"integer"},"total":{"format":"int32","type":"integer"}}},"account_transaction":{"description":"Document representing an account transaction","properties":{"amount":{"$ref":"#/definitions/money","description":"The amount of the gift certificate"},"order_no":{"description":"The order number of the gift certificate","type":"string"},"timestamp":{"description":"The timestamp of the transaction of the gift certificate","format":"date-time","type":"string"},"type_code":{"description":"The type code of the gift certificate","enum":["create","redeem","delete","enable","disable"],"type":"string"}}},"alert_descriptor":{"description":"Document describing a single alert descriptor.","properties":{"application_context_path":{"description":"The application context path.","minLength":1,"type":"string"},"application_id":{"description":"The application ID.","minLength":1,"type":"string"},"context_object_type":{"description":"The context object type.","type":"string"},"default_priority":{"description":"The default priority.","enum":["not_allowed","hidden","informational","warning","action_required"],"minLength":1,"type":"string"},"link":{"description":"URL for this resource.","minLength":1,"type":"string"},"message_id":{"description":"The message ID.","minLength":1,"type":"string"}}},"alert_descriptor_settings":{"description":"Document describing settings for a single alert descriptor.","properties":{"application_context_path":{"description":"The application context path.","minLength":1,"type":"string"},"application_id":{"description":"The application ID.","minLength":1,"type":"string"},"is_user_override":{"description":"Flag that indicates whether the settings for this descriptor have been changed by the user. In a PATCH request, this flag must be set to true to override the default settings. If this flag to false in a PATCH request, the default user settings for this descriptor are restored (and all other fields are ignored).","type":"boolean"},"message_id":{"description":"The message ID.","minLength":1,"type":"string"},"priority":{"description":"The user priority.","enum":["hidden","informational","warning","action_required"],"type":"string"},"show_in_header":{"description":"Flag that indicates whether the alert is shown in the Business Manager header.","type":"boolean"},"show_on_homepage":{"description":"Flag that indicates whether the alert is shown on the Business Manager homepage.","type":"boolean"}},"required":["application_context_path","application_id","is_user_override","message_id","priority","show_in_header","show_on_homepage"]},"alert_descriptors":{"description":"Document containing a collection of alert descriptors.","properties":{"data":{"description":"Collection of alert descriptors","items":{"$ref":"#/definitions/alert_descriptor"},"type":"array"}}},"alert_descriptors_revalidation_request":{"description":"Contains parameters for a alert descriptor revalidation request.","properties":{"context_object_id":{"description":"ID of the object in which context messages should be revalidated.","type":"string"}}},"alert_item":{"description":"Document describing a single alert.","properties":{"application_context_path":{"description":"The application context path.","minLength":1,"type":"string"},"application_id":{"description":"The application ID.","minLength":1,"type":"string"},"context_object_id":{"description":"The context object id.","type":"string"},"description":{"description":"The description.","minLength":1,"type":"string"},"display_message":{"description":"The display message.","minLength":1,"type":"string"},"link":{"description":"URL for this resource.","minLength":1,"type":"string"},"message_id":{"description":"The message ID.","minLength":1,"type":"string"},"remediation_action":{"description":"The remediation action.","minLength":1,"type":"string"},"user_priority":{"description":"The user priority.","enum":["not_allowed","hidden","informational","warning","action_required"],"minLength":1,"type":"string"}}},"alert_items":{"description":"Document containing a collection of alerts.","properties":{"data":{"description":"Collection of alerts","items":{"$ref":"#/definitions/alert_item"},"type":"array"}}},"alert_settings":{"description":"Document containing the alert settings of a user.","properties":{"settings":{"description":"Alert settings.","items":{"$ref":"#/definitions/alert_descriptor_settings"},"type":"array"}}},"application_permissions":{"description":"Document representing the available applications for retrieving permissions.","properties":{"applications":{"description":"The available applications (e.g. 'bm' for Business Manager).","items":{"type":"string"},"type":"array"},"bm":{"$ref":"#/definitions/bmpermissions","description":"The permissions of application 'bm'."},"csc":{"$ref":"#/definitions/cscpermissions","description":"The permissions of application 'csc'."}}},"bmpermissions":{"properties":{"functional":{"$ref":"#/definitions/functional_permissions"},"functional_link":{"type":"string"},"locale":{"$ref":"#/definitions/locale_permissions"},"locale_link":{"type":"string"},"module":{"$ref":"#/definitions/module_permissions"},"module_link":{"type":"string"},"types":{"items":{"type":"string"},"type":"array"},"webdav":{"$ref":"#/definitions/webdav_permissions"},"webdav_link":{"type":"string"}}},"bool_filter":{"description":"Document representing a boolean filter.\n ","properties":{"filters":{"description":"A list of filters, which are logically combined by an operator.","items":{"$ref":"#/definitions/filter"},"x-sub_types":{"range_filter":"#/definitions/range_filter","bool_filter":"#/definitions/bool_filter","query_filter":"#/definitions/query_filter","term_filter":"#/definitions/term_filter","range2_filter":"#/definitions/range2_filter"},"type":"array"},"operator":{"description":"The logical operator the filters are combined with.","enum":["and","or","not"],"type":"string"}},"required":["operator"]},"bool_query":{"description":"A boolean query allows construction of full logical expression trees consisting of other queries (usually term and text\nqueries). A boolean query basically has 3 sets of clauses that 'must', 'should' and / or 'must not' match.  If 'must',\n'must_not', or 'should' appear in the same boolean query, they are combined logically using the AND operator.\n","properties":{"must":{"description":"List of queries that must match.","items":{"$ref":"#/definitions/query"},"x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"},"type":"array"},"must_not":{"description":"List of queries that must not match.","items":{"$ref":"#/definitions/query"},"x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"},"type":"array"},"should":{"description":"List of queries that should match.","items":{"$ref":"#/definitions/query"},"x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"},"type":"array"}}},"campaign":{"description":"Document representing a campaign.","properties":{"campaign_id":{"description":"The ID of the campaign.","x-label":{"default":"ID"},"maxLength":256,"minLength":1,"type":"string"},"coupons":{"description":"The array of assigned coupon IDs, not sorted","items":{"type":"string"},"type":"array"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"customer_groups":{"description":"The array of assigned customer groups, not sorted","items":{"type":"string"},"type":"array"},"description":{"description":"The description of the campaign.","format":"text","x-label":{"default":"Description"},"maxLength":4000,"type":"string"},"enabled":{"description":"The enabled flag for campaign.","type":"boolean"},"end_date":{"description":"The date that the Scenario ends","format":"date-time","x-label":{"default":"End Date"},"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"link for convenience","type":"string"},"source_code_groups":{"description":"The array of assigned source code groups, not sorted","items":{"type":"string"},"type":"array"},"start_date":{"description":"The date that the Scenario begins","format":"date-time","x-label":{"default":"Start Date"},"type":"string"}}},"campaign_search_result":{"description":"Document representing a campaign search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/campaign"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"campaigns":{"description":"Document representing an unfiltered list of campaigns.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/campaign"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"cartridge_path_add_request":{"description":"Request body for post operation","properties":{"name":{"description":"Name of the cartridge.","type":"string"},"position":{"description":"Position of the cartridge.","enum":["first","last","before","after"],"type":"string"},"target":{"description":"When position is 'before' or 'after', need to specify the target cartridge","type":"string"}},"required":["name","position"]},"cartridge_path_api_response":{"description":"Response of cartridge path related operation","properties":{"cartridges":{"description":"Updated cartridge path","type":"string"},"site_id":{"description":"Site id","type":"string"}}},"cartridge_path_create_request":{"description":"Request Body for put operation","properties":{"cartridges":{"description":"New cartridge path","type":"string"}},"required":["cartridges"]},"catalog":{"description":"Document representing a catalog","properties":{"assigned_product_count":{"description":"The count of products assigned to the catalog. It is read only.","format":"int32","type":"integer"},"assigned_sites":{"description":"The sites assigned to the catalog. It is read only.","items":{"$ref":"#/definitions/site"},"type":"array"},"category_count":{"description":"The category count of catalog. It is read only.","format":"int32","type":"integer"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"description":{"additionalProperties":{"type":"string"},"description":"The description of catalog","format":"localized","x-label":{"default":"Description"},"type":"object"},"id":{"description":"The catalog Id","x-label":{"default":"ID"},"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"URL that is used to get this instance. It is read only.","type":"string"},"name":{"additionalProperties":{"type":"string"},"description":"The catalog name","format":"localized","x-label":{"default":"Name"},"type":"object"},"online":{"description":"The online status of catalog","type":"boolean"},"owned_product_count":{"description":"The count of products owned by the catalog. It is read only.","format":"int32","type":"integer"},"recommendation_count":{"description":"The recommendation count of the catalog. It is read only.","format":"int32","type":"integer"},"root_category":{"description":"The root category of the catalog.  It is read only","type":"string"}}},"catalog_category_id":{"description":"Document representing a catalog category id.","properties":{"catalog_id":{"description":"The id of the catalog that owns the category.","maxLength":256,"minLength":1,"type":"string"},"category_id":{"description":"The id of the category.","maxLength":256,"minLength":1,"type":"string"}}},"catalog_search_result":{"description":"Document representing a catalog search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/catalog"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"catalogs":{"description":"Document representing an unfiltered list of catalogs.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"The collection of catalogs.","items":{"$ref":"#/definitions/catalog"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"categories":{"description":"Document representing an unfiltered list of categories.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/category"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"category":{"description":"Document representing a category.","properties":{"c_alternativeUrl":{"$ref":"#/definitions/markup_text","description":"Renders an alternative URL in main navigation. Uses Salesforce Commerce Cloud content url notation. For example: $url('Account-Show')$ or normal URL http://xchange.demandware.com","x-label":{"default":"Alternative URL"}},"c_catBannerID":{"description":"Used to define the content asset used to populate a grid page banner for a category. This value is applied to all sub-category navigation (cascading) if no specific catBannerID has been defined for  a sub-category.","x-label":{"default":"Category Banner ID"},"type":"string"},"c_customCSSFile":{"$ref":"#/definitions/media_file","description":"Use this attribute to apply custom styles for this category.","x-label":{"default":"Custom CSS File"}},"c_enableCompare":{"description":"Used to define if/when the Compare feature is to be visualized in the storefront based on navigation. If enableCompare = FALSE, no Compare checkboxes will be displayed in the grid view. If enableCompare = TRUE, the category (and its children) will support the Compare feature.","x-label":{"default":"Enable Compare"},"type":"boolean"},"c_headerMenuBanner":{"$ref":"#/definitions/markup_text","x-label":{"default":"Header Menu Banner"}},"c_headerMenuOrientation":{"description":"Which way to orient the menu and optional header menu HTML. Vertical will list all in one line. Horizontal will list in columns.","enum":["Horizontal","Vertical"],"x-enum-labels":[{"default":"Horizontal"},{"default":"Vertical"}],"x-label":{"default":"Header Menu Orientation"},"type":"string"},"c_showInMenu":{"description":"Used to indicate that a category (such as Mens -> Footwear -> Boots) will display in the roll-over navigation. A sub-category only shows if also the parent category is marked as showInMenu. Up to three category levels are shown in roll-over navigation.","x-label":{"default":"Show in Menu Navigation"},"type":"boolean"},"c_sizeChartID":{"description":"Used to define the content asset ID of the Size Chart that is appropriate for products whose PRIMARY category is the associated category (and its children). Whenever a product detail page (or quick view) is rendered, the Size Chart link is populated based on the value of this attribute for the products primary categorization. If not defined, NO size chart link is displayed.","x-label":{"default":"Size Chart"},"type":"string"},"c_slotBannerHtml":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"format":"localized","x-label":{"default":"Slot Banner HTML"},"type":"object"},"c_slotBannerImage":{"$ref":"#/definitions/media_file","description":"Image used on either the top or bottom slot on the category landing pages.","x-label":{"default":"Category Landing Slot Image"}},"catalog_id":{"description":"The id of the catalog that contains it.","x-label":{"default":"ID"},"type":"string"},"categories":{"description":"The array of sub categories for the category.","items":{"$ref":"#/definitions/category"},"type":"array"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"description":{"additionalProperties":{"type":"string"},"description":"The localized description of the category.","format":"localized","x-label":{"default":"Description"},"type":"object"},"id":{"description":"The id of the category.","x-label":{"default":"ID"},"maxLength":256,"minLength":1,"type":"string"},"image":{"description":"The name of the category image. The URL to the image is computed.","x-label":{"default":"Standard Image"},"maxLength":256,"minLength":1,"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"The URL to get the category. This is a computed attribute and cannot be modified.","type":"string"},"name":{"additionalProperties":{"type":"string"},"description":"The localized name of the category.","format":"localized","x-label":{"default":"Name"},"type":"object"},"online":{"description":"The online status of the category determines if it is visible in the storefront. Defaults to false if not specified on create.","x-label":{"default":"Online"},"type":"boolean"},"page_description":{"additionalProperties":{"type":"string"},"description":"The localized page description of the category.","format":"localized","x-label":{"default":"Page Description"},"type":"object"},"page_keywords":{"additionalProperties":{"type":"string"},"description":"The localized page keywords for the category.","format":"localized","x-label":{"default":"Page Keywords"},"type":"object"},"page_title":{"additionalProperties":{"type":"string"},"description":"The localized page title of the category.","format":"localized","x-label":{"default":"Page Title"},"type":"object"},"parent_category_id":{"description":"The id of the parent category. Defaults to root if not specified on create.","maxLength":256,"minLength":1,"type":"string"},"paths":{"items":{"$ref":"#/definitions/path_record"},"type":"array"},"position":{"description":"The position of the category determines the display order in the storefront.","format":"double","type":"number"},"sorting_rules":{"items":{"$ref":"#/definitions/sorting_rule"},"type":"array"},"thumbnail":{"description":"The name of the category thumbnail. The URL to the thumbnail is computed.","x-label":{"default":"Thumbnail Image"},"maxLength":256,"minLength":1,"type":"string"}}},"category_link":{"description":"Document representing a category link","properties":{"last_modified":{"description":"The date the link was last modified","format":"date-time","type":"string"},"link":{"description":"URL that is used to get this instance","type":"string"},"position":{"description":"The position in the source catalog / category for this link relative to the other links in the same category.","format":"double","minimum":0.0,"type":"number"},"source_catalog_id":{"description":"The source catalog for the link","type":"string"},"source_catalog_name":{"additionalProperties":{"type":"string"},"description":"The name of the source catalog","format":"localized","type":"object"},"source_category_id":{"description":"The source category for the link","type":"string"},"source_category_name":{"additionalProperties":{"type":"string"},"description":"The name of the source category","format":"localized","type":"object"},"target_catalog_id":{"description":"The target category for the link","type":"string"},"target_catalog_name":{"additionalProperties":{"type":"string"},"description":"The name of the target catalog","format":"localized","type":"object"},"target_category_id":{"description":"The target category for the link","type":"string"},"target_category_name":{"additionalProperties":{"type":"string"},"description":"The name of the target category","format":"localized","type":"object"},"type":{"description":"The link type","enum":["other","accessories","cross_selling","up_selling","spare_parts"],"type":"string"}}},"category_links":{"description":"Document representing an unfiltered list of category links.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/category_link"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"category_product_assignment":{"description":"Document representing a category product assignment.","properties":{"catalog_id":{"description":"The id of the catalog.","maxLength":256,"minLength":1,"type":"string"},"category_id":{"description":"The id of the category.","maxLength":256,"minLength":1,"type":"string"},"link":{"description":"The URL used to get the product category assignment.","type":"string"},"owning_catalog_name":{"additionalProperties":{"type":"string"},"description":"The name of the catalog that owns the product.","format":"localized","type":"object"},"position":{"description":"The position of product category assignment.","format":"double","type":"number"},"product":{"$ref":"#/definitions/product","description":"The product that is assigned to the category."},"product_id":{"description":"The id of the Product.","maxLength":256,"minLength":1,"type":"string"},"product_name":{"additionalProperties":{"type":"string"},"description":"The name of the product.","format":"localized","type":"object"}}},"category_product_assignment_search_request":{"description":"Document representing product_search_request","properties":{"count":{"description":"The number of returned documents.","format":"int32","maximum":200,"minimum":1,"type":"integer"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"The list of expansions that can be applied:\n \n product_base - String - This expand will enable retrieval of the following basic Product information:\n \t\n \t\tbrand\n    \tean\n      link\n  \tlong_description\n      manufacturer_name\n      manufacturer_sku\n \t\tname\n      page_description\n      page_keywords\n      page_title\n      searchable\n   \tshort_description\n      type\n      unit\n     \tupc\n \t\n ","items":{"type":"string"},"type":"array"},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"}},"required":["query"]},"category_product_assignment_search_result":{"description":"Document representing a product search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. This array can be empty.","items":{"$ref":"#/definitions/category_product_assignment"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"category_search_result":{"description":"Document representing a catalog search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/category"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"code_version":{"description":"Document representing a code version","properties":{"activation_time":{"description":"The code version activation time.","format":"date-time","type":"string"},"active":{"description":"Use this method to determine, if this code version is currently active.","type":"boolean"},"cartridges":{"description":"A list containing the names of all cartridges participating in this code version.","items":{"type":"string"},"type":"array"},"compatibility_mode":{"description":"The code version compatibility mode.","type":"string"},"id":{"description":"The code version id.","type":"string"},"last_modification_time":{"description":"The last time, when the code version was changed.","format":"date-time","type":"string"},"rollback":{"description":"Use this method to determine, if this code version is the current rollback version.","type":"boolean"},"total_size":{"description":"Returns the total size of the file system content of this code version in bytes.","format":"int64","type":"integer"},"web_dav_url":{"description":"Returns the HTTPS based WebDAV URL that can be used to access the code version resources.","type":"string"}}},"code_version_result":{"description":"Result document containing an array of code versions.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"The array of code versions","items":{"$ref":"#/definitions/code_version"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"content_asset":{"description":"Document representing a content asset.","properties":{"c_Year":{"x-label":{"default":"Year"},"type":"string"},"c_body":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"format":"localized","x-label":{"default":"Body"},"type":"object"},"c_customCSSFile":{"$ref":"#/definitions/media_file","description":"Use this attribute to apply custom styles for this content asset.","x-label":{"default":"Custom CSS File"}},"classification_folder_id":{"description":"The ID of the classification folder. It is only part of the response, if the assignment from  this content asset to the folder is marked as 'default'. The property is read-only. To  set the classification folder just create/update an assignment between this content asset and  a folder and mark it as 'default'. See details in  /libraries/{library_id}/folder_assignments/{content_id}/{folder_id} resource.","type":"string"},"classification_folder_link":{"description":"The link to the classification folder. It is only part of the response, if the assignment from  this content asset to the folder is marked as 'default'. The property is read-only. To  set the classification folder just create/update an assignment between this content asset and  a folder and mark it as 'default'. See details in  /libraries/{library_id}/folder_assignments/{content_id}/{folder_id} resource.","type":"string"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"description":{"additionalProperties":{"type":"string"},"description":"The localized content asset description.","format":"localized","x-label":{"default":"Description"},"type":"object"},"id":{"description":"The id of the content asset.","x-label":{"default":"ID"},"maxLength":256,"minLength":1,"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"The link to the content asset resource.","type":"string"},"name":{"additionalProperties":{"type":"string"},"description":"The localized content asset name.","format":"localized","x-label":{"default":"Name"},"type":"object"},"online":{"additionalProperties":{"type":"boolean"},"description":"Is the asset online?","format":"site-specific","x-label":{"default":"Online"},"type":"object"},"page_description":{"additionalProperties":{"type":"string"},"description":"The localized content asset page description.","format":"localized","x-label":{"default":"Page Description"},"type":"object"},"page_keywords":{"additionalProperties":{"type":"string"},"description":"The localized content asset page keywords.","format":"localized","x-label":{"default":"Page Keywords"},"type":"object"},"page_title":{"additionalProperties":{"type":"string"},"description":"The localized content asset page title.","format":"localized","x-label":{"default":"Page Title"},"type":"object"},"page_url":{"additionalProperties":{"type":"string"},"description":"The localized content asset page url.","format":"localized","x-label":{"default":"Page URL"},"type":"object"},"searchable":{"additionalProperties":{"type":"boolean"},"description":"Is the asset searchable?","format":"site-specific","type":"object"},"site_map_change_frequency":{"additionalProperties":{"enum":["always","hourly","daily","weekly","monthly","yearly","never"],"x-enum-labels":[{"default":"always"},{"default":"hourly"},{"default":"daily"},{"default":"weekly"},{"default":"monthly"},{"default":"yearly"},{"default":"never"}],"type":"string"},"description":"The content assets change frequency needed for the sitemap creation  (always, hourly, daily, weekly, monthly, yearly, never).","format":"site-specific","x-label":{"default":"Change Frequency"},"type":"object"},"site_map_included":{"additionalProperties":{"enum":[1,0],"x-enum-labels":[{"default":"YES"},{"default":"NO"}],"format":"int32","maximum":1,"minimum":0,"type":"integer"},"description":"The status if the content asset is included into the sitemap (either 0 or  1).","format":"site-specific","x-label":{"default":"Included"},"type":"object"},"site_map_priority":{"additionalProperties":{"format":"double","maximum":1.0,"type":"number"},"description":"The content assets priority needed for the sitemap creation (0.0 for no  priority defined).","format":"site-specific","x-label":{"default":"Priority"},"type":"object"},"template":{"description":"The rendering template.","x-label":{"default":"Rendering Template"},"type":"string"}}},"content_asset_result":{"description":"Result document containing an array of content assets.","properties":{"count":{"description":"The number of search results in the current page.","format":"int32","type":"integer"},"data":{"description":"The returned objects.","items":{"type":"object"},"type":"array"},"hits":{"description":"The sorted array of search hits. This array can be empty.","items":{"$ref":"#/definitions/content_asset"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search result to include in the document.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of search results.","format":"int32","type":"integer"}}},"content_folder":{"description":"Document representing a content folder.","properties":{"c_customCSSFile":{"$ref":"#/definitions/media_file","description":"Use this attribute to apply custom styles for this category.","x-label":{"default":"Custom CSS File"}},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"description":{"additionalProperties":{"type":"string"},"description":"The localized content folder description.","format":"localized","x-label":{"default":"Description"},"type":"object"},"id":{"description":"The id of the content folder.","x-label":{"default":"ID"},"maxLength":256,"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"The link to the content folder resource.","type":"string"},"name":{"additionalProperties":{"type":"string"},"description":"The localized content folder name.","format":"localized","x-label":{"default":"Name"},"type":"object"},"online":{"description":"A flag indicating whether the folder in online (default is false).","x-label":{"default":"Online"},"type":"boolean"},"page_description":{"additionalProperties":{"type":"string"},"description":"The localized content folder page description.","format":"localized","x-label":{"default":"Page Description"},"type":"object"},"page_keywords":{"additionalProperties":{"type":"string"},"description":"The localized content folder page keywords.","format":"localized","x-label":{"default":"Page Keywords"},"type":"object"},"page_title":{"additionalProperties":{"type":"string"},"description":"The localized content folder page title.","format":"localized","x-label":{"default":"Page Title"},"type":"object"},"page_url":{"additionalProperties":{"type":"string"},"description":"The localized content folder page URL.","format":"localized","x-label":{"default":"Page URL"},"type":"object"},"parent_folder_id":{"description":"The id of the parent content folder.","type":"string"},"parent_link":{"description":"The URL to the parent content folder.","type":"string"},"sub_folders_link":{"description":"The URL to list the content sub-folders.","type":"string"},"template":{"description":"The rendering template.","x-label":{"default":"Rendering Template"},"type":"string"}}},"content_folder_assignment":{"description":"Document representing a content folder assignment.","properties":{"content_id":{"description":"The content id.","maxLength":256,"type":"string"},"content_link":{"description":"The content link.","type":"string"},"default":{"description":"A flag indicating whether the assignment is the default one.","type":"boolean"},"folder_id":{"description":"The folder id.","maxLength":256,"type":"string"},"folder_link":{"description":"The folder link.","type":"string"},"position":{"description":"The position of the content asset in the folder.","format":"double","minimum":0.0,"type":"number"}}},"content_folder_result":{"description":"Result document containing an array of content folders.","properties":{"count":{"description":"The number of search results in the current page.","format":"int32","type":"integer"},"data":{"description":"The returned objects.","items":{"type":"object"},"type":"array"},"hits":{"description":"The sorted array of search hits. This array can be empty.","items":{"$ref":"#/definitions/content_folder"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search result to include in the document.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of search results.","format":"int32","type":"integer"}}},"content_sub_folder_result":{"description":"Result document containing an array of content subfolders.","properties":{"count":{"description":"The number of search results in the current page.","format":"int32","type":"integer"},"data":{"description":"The returned objects.","items":{"type":"object"},"type":"array"},"hits":{"description":"The sorted array of search hits. This array can be empty.","items":{"$ref":"#/definitions/content_folder"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search result to include in the document.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of search results.","format":"int32","type":"integer"}}},"coupon":{"description":"Document representing a coupon.","properties":{"coupon_id":{"description":"The id of the coupon.","x-label":{"default":"ID"},"maxLength":256,"minLength":1,"readOnly":true,"type":"string"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"description":{"description":"The description of the coupon.","maxLength":4000,"type":"string"},"enabled":{"description":"A flag indicating whether the coupon is enabled.","x-label":{"default":"Enabled"},"type":"boolean"},"exported_code_count":{"description":"The number of coupon codes attached to the coupon that have been issued (request search only).","format":"int32","type":"integer"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"A link to the coupon.","type":"string"},"redemption_count":{"description":"The number of times the coupon has been redeemed (request search only).","format":"int32","type":"integer"},"redemption_limits":{"$ref":"#/definitions/redemption_limits","description":"The redemption limit per coupon code."},"single_code":{"description":"Single coupon code, only valid for Single Code type","maxLength":256,"minLength":1,"type":"string"},"system_codes_config":{"$ref":"#/definitions/coupon_system_code_config","description":"The configuration of system coupon codes, including pre-fix and number of codes"},"total_codes_count":{"description":"The total number of coupon codes associated with this coupon","format":"int32","type":"integer"},"type":{"description":"The type of the coupon code.","enum":["single_code","multiple_codes","system_codes"],"x-enum-labels":[{"default":"Coupon with single fixed code"},{"default":"Coupon with multiple fixed codes"},{"default":"Coupon with system generated codes"}],"x-label":{"default":"Type"},"readOnly":true,"type":"string"}}},"coupon_code":{"description":"A coupon code with accompanying stats for redemptions and issued.","properties":{"code":{"description":"The code used to redeem the coupon","type":"string"},"issued":{"description":"Flag indicating if the coupon code has been issued","type":"boolean"},"redemption_count":{"description":"The count of the number of redemptions associated with the code","format":"int32","type":"integer"}}},"coupon_codes":{"description":"Document representing a set of coupon codes.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"The collection of coupon codes","items":{"$ref":"#/definitions/coupon_code"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"coupon_multi_codes_request":{"description":"A request object to add and remove coupon codes from a document","properties":{"codes":{"description":"The list of coupon codes to add or delete","items":{"type":"string"},"type":"array"}},"required":["codes"]},"coupon_redemption":{"description":"A redemption record returned from the coupon redemption resources","properties":{"code":{"description":"The coupon code that was redeemed","type":"string"},"coupon_id":{"description":"The coupon id that was redeemed","type":"string"},"creation_date":{"description":"Date when the redemption was created","format":"date-time","type":"string"},"customer_email":{"description":"The customer email that was used to redeem it","type":"string"},"order_no":{"description":"The order number where the redemption occurred","type":"string"},"view_order_url":{"description":"A URL able to access the order","type":"string"}}},"coupon_redemption_search_result":{"description":"The result of the coupon redemption search","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The hits from the search","items":{"$ref":"#/definitions/coupon_redemption"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"coupon_search_result":{"description":"Document representing a coupon search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/coupon"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"coupon_system_code_config":{"properties":{"code_prefix":{"description":"The code prefix for system-generated coupon codes.","x-label":{"default":"Code Prefix"},"type":"string"},"number_of_codes":{"description":"The number of system coupon codes that can be issued.","format":"int32","type":"integer"}}},"coupons":{"description":"Document representing an unfiltered list of coupons.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/coupon"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"credentials":{"description":"Document representing the credentials of a customer.","properties":{"enabled":{"description":"A flag indicating whether the customer is enabled and can log.","type":"boolean"},"locked":{"description":"A flag indicating whether the customer account is locked.","type":"boolean"},"login":{"description":"The login of the customer.","maxLength":256,"type":"string"},"password_question":{"description":"The password question.","maxLength":256,"type":"string"}},"required":["login"]},"cscpermissions":{"properties":{"module":{"$ref":"#/definitions/module_permissions"},"module_link":{"type":"string"},"types":{"items":{"type":"string"},"type":"array"}}},"custom_log_settings":{"description":"Document representing custom logging settings.","properties":{"debug_permitted":{"description":"False if the current instance is production.","type":"boolean"},"debug_to_file":{"description":"Indicates if custom debug logs are written to file.","type":"boolean"},"email_to":{"description":"Email addresses for fatal log messages with a maximum length of 1000 characters.","maxLength":1000,"type":"string"},"error_to_file":{"description":"Indicates if custom error logs are written to file.","type":"boolean"},"fatal_to_file":{"description":"Indicates if custom fatal logs are written to file.","type":"boolean"},"info_to_file":{"description":"Indicates if custom info logs are written to file.","type":"boolean"},"log_categories":{"description":"Defined custom log categories.","items":{"$ref":"#/definitions/log_category"},"type":"array"},"root_level":{"description":"Custom root category log level.","type":"string"},"warn_to_file":{"description":"Indicates if custom warn logs are written to file.","type":"boolean"}}},"custom_object":{"description":"Document representing a custom object that contains all defined custom attributes for its object type.Document representing a custom object that contains all defined custom attributes for its object type.","properties":{"key_property":{"description":"The name of the key property for the custom object. This is ignored in input documents.","type":"string"},"key_value_integer":{"description":"The id of the custom object when the type of the key is Integer. This is ignored in input documents.","format":"int32","type":"integer"},"key_value_string":{"description":"The id of the custom object when the type of the key is String. This is ignored in input documents.","type":"string"},"object_type":{"description":"The id of the object type. This is ignored in input documents.","type":"string"}}},"custom_object_search_result":{"description":"Document representing a custom object search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. May be empty.","items":{"$ref":"#/definitions/custom_object"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"customer":{"description":"Document representing a customer.","properties":{"birthday":{"description":"The customer's birthday.","format":"date","x-label":{"default":"Birthday"},"type":"string"},"c_familyStatus":{"x-label":{"default":"Family Status"},"type":"string"},"company_name":{"description":"The customer's company name.","x-label":{"default":"Company"},"maxLength":256,"type":"string"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"credentials":{"$ref":"#/definitions/credentials","description":"The customer's credentials."},"customer_id":{"description":"The customer's id. Both registered and guest customers have a\n customer id.","maxLength":28,"type":"string"},"customer_no":{"description":"The customer's number.","x-label":{"default":"Customer No."},"maxLength":100,"type":"string"},"email":{"description":"The customer's email address.","format":"email","x-label":{"default":"Email"},"maxLength":256,"type":"string"},"fax":{"description":"The fax number to use for the customer.\n The length is restricted to 32 characters.","x-label":{"default":"Fax Number"},"maxLength":32,"type":"string"},"first_name":{"description":"The customer's first name.","x-label":{"default":"First Name"},"maxLength":256,"type":"string"},"gender":{"description":"The customer's gender.","enum":[1,2],"x-enum-labels":[{"default":"Male"},{"default":"Female"}],"format":"int32","x-label":{"default":"Gender"},"type":"integer"},"global_party_id":{"description":"The Global Party ID is set by Customer 360 and identifies a person across multiple systems.","type":"string"},"job_title":{"description":"The customer's job title.","x-label":{"default":"Job Title"},"maxLength":256,"type":"string"},"last_login_time":{"description":"The last login time of the customer.","format":"date-time","x-label":{"default":"Last Login Time"},"readOnly":true,"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"last_name":{"description":"The customer's last name.","x-label":{"default":"Last Name"},"maxLength":256,"type":"string"},"last_visit_time":{"description":"The last visit time of the customer.","format":"date-time","x-label":{"default":"Last Visit Time"},"readOnly":true,"type":"string"},"phone_business":{"description":"The customer's business phone number.","x-label":{"default":"Business Phone"},"maxLength":32,"type":"string"},"phone_home":{"description":"The customer's home phone number.","x-label":{"default":"Home Phone"},"maxLength":32,"type":"string"},"phone_mobile":{"description":"The customer's mobile phone number.","x-label":{"default":"Mobile Phone"},"maxLength":32,"type":"string"},"preferred_locale":{"description":"The customer's preferred locale, formatted with a hyphen. (For example: en-US)\n If the request uses an underscore, as with the Java locale format, the stored value is converted to a hyphen.\n (For example: en_US is stored as en-US)","x-label":{"default":"Preferred Locale"},"readOnly":true,"type":"string"},"previous_login_time":{"description":"The time when the customer logged in previously.","format":"date-time","type":"string"},"previous_visit_time":{"description":"The time when the customer previously visited the store.","format":"date-time","type":"string"},"primary_address":{"$ref":"#/definitions/customer_address","description":"The customers primary or default address."},"salutation":{"description":"The customer's salutation.","x-label":{"default":"Salutation"},"maxLength":256,"type":"string"},"second_name":{"description":"The customer's second name.","x-label":{"default":"Second Name"},"maxLength":256,"type":"string"},"suffix":{"description":"The customer's suffix (for example, \"Jr.\" or \"Sr.\").","x-label":{"default":"Name Suffix"},"maxLength":256,"type":"string"},"title":{"description":"The customer's title (for example, \"Mrs\" or \"Mr\").","x-label":{"default":"Title"},"maxLength":256,"type":"string"}}},"customer_address":{"description":"Document representing a customer address.","properties":{"address1":{"description":"The customer's first address.","x-label":{"default":"Address 1"},"maxLength":256,"type":"string"},"address2":{"description":"The customer's second address value.","x-label":{"default":"Address 2"},"maxLength":256,"type":"string"},"address_id":{"description":"The customer address id.","x-label":{"default":"Address ID"},"maxLength":256,"type":"string"},"city":{"description":"The customer's city.","x-label":{"default":"City"},"maxLength":256,"type":"string"},"company_name":{"description":"The customer's company name.","x-label":{"default":"Company"},"maxLength":256,"type":"string"},"country_code":{"description":"The customer's two-character country code per ISO 3166-1 alpha-2.","enum":["US","FR","IT","JP","CN","GB"],"x-enum-labels":[{"default":"United States"},{"default":"France"},{"default":"Italy"},{"default":"Japan"},{"default":"China"},{"default":"United Kingdom"}],"x-label":{"default":"Country"},"maxLength":2,"type":"string"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"etag":{"description":"The generated eTag representing the state of the customer address.","type":"string"},"first_name":{"description":"The customer's first name.","x-label":{"default":"First Name"},"maxLength":256,"type":"string"},"full_name":{"description":"The concatenation of the customer's first, middle, and last names and its suffix.","type":"string"},"job_title":{"description":"The customer's job title.","x-label":{"default":"Job Title"},"maxLength":256,"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"last_name":{"description":"The customer's last name.","x-label":{"default":"Last Name"},"maxLength":256,"type":"string"},"phone":{"description":"The customer's phone number.","x-label":{"default":"Contact Phone"},"maxLength":32,"type":"string"},"post_box":{"description":"The customer's post box.","x-label":{"default":"Post Box"},"maxLength":256,"type":"string"},"postal_code":{"description":"The customer's postal code.","x-label":{"default":"Postal Code"},"maxLength":256,"type":"string"},"salutation":{"description":"The customer's salutation.","x-label":{"default":"Salutation"},"maxLength":256,"type":"string"},"second_name":{"description":"The customer's second name.","x-label":{"default":"Second Name"},"maxLength":256,"type":"string"},"state_code":{"description":"The customer's state.","x-label":{"default":"State"},"maxLength":256,"type":"string"},"suffix":{"description":"The customer's suffix.","x-label":{"default":"Suffix"},"maxLength":256,"type":"string"},"suite":{"description":"The customer's suite.","x-label":{"default":"Suite No."},"maxLength":32,"type":"string"},"title":{"description":"The customer's title.","x-label":{"default":"Title"},"maxLength":256,"type":"string"}},"required":["address_id","country_code","last_name"]},"customer_address_result":{"description":"Result document containing an array of customer addresses.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"The array of customer address documents.","items":{"$ref":"#/definitions/customer_address"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"customer_group":{"description":"Document representing a customer group","properties":{"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"description":{"description":"The description for the customer group.  This property is read-only for system groups.","x-label":{"default":"Description"},"type":"string"},"id":{"description":"The user specific identifier for the customer group, which must be unique across the organization.  Property\n is read-only.","x-label":{"default":"ID"},"maxLength":256,"minLength":1,"readOnly":true,"type":"string"},"in_deletion":{"description":"The deletion status of this customer group.","type":"boolean"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"URL that is used to get this instance.  This property is computed and cannot be modified.","type":"string"},"member_count":{"description":"The number of members in this customer group.","format":"int32","type":"integer"},"rule":{"$ref":"#/definitions/rule","description":"The rule of this customer group. Only available for dynamic customer groups."},"type":{"description":"The type of the customer group.  This property is read-only.","enum":["system","dynamic","static"],"type":"string"}}},"customer_group_member":{"description":"Document representing a customer group member","properties":{"active":{"description":"A flag indicating whether the customer is enabled and can log in.","type":"boolean"},"c_familyStatus":{"x-label":{"default":"Family Status"},"type":"string"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"customer_link":{"description":"The link to the customer resource.","maxLength":256,"type":"string"},"customer_no":{"description":"The customers number (id).","x-label":{"default":"Customer No."},"maxLength":100,"type":"string"},"email":{"description":"The customer's email address.","format":"email","x-label":{"default":"Email"},"maxLength":256,"type":"string"},"first_name":{"description":"The customer's first name.","x-label":{"default":"First Name"},"maxLength":256,"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"last_name":{"description":"The customer's last name.","x-label":{"default":"Last Name"},"maxLength":256,"type":"string"},"link":{"description":"The link to the customer group member resource.","maxLength":256,"type":"string"},"login":{"description":"The login of the customer.","maxLength":256,"type":"string"}}},"customer_group_member_search_result":{"description":"Document representing a customer group member search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/customer_group_member"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"customer_group_members":{"description":"Document representing an unfiltered list of customer groups.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/customer_group_member"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"customer_group_search_result":{"description":"Document representing a customer group search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/customer_group"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"customer_groups":{"description":"Document representing an unfiltered list of customer groups.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/customer_group"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"customer_list":{"description":"Document representing a customer list.","properties":{"id":{"description":"The id of the customer list.","minLength":1,"type":"string"}},"required":["id"]},"customer_list_link":{"description":"Document representing a link to a customer list.","properties":{"customer_list_id":{"description":"The customerlist id.","type":"string"},"link":{"description":"The target of the link.","type":"string"},"title":{"additionalProperties":{"type":"string"},"description":"The link title.","format":"localized","type":"object"}}},"customer_search_hit":{"description":"Document representing a customer search hit.","properties":{"data":{"$ref":"#/definitions/customer","description":""},"relevance":{"description":"The hit's relevance score.","format":"double","type":"number"}}},"customer_search_result":{"description":"Document representing a customer search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"format":"int32","minimum":0,"type":"integer"},"expand":{"description":"The list of expands set. Can be empty.","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/customer_search_hit"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The requested query string.","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"ecdn_log_fetch_request":{"description":"Input-Document for requesting a Log-Fetch process.","properties":{"end_time":{"description":"Optional end time for log file entries, in Unix time stamp format. Must not be more than 1 hour after the start time. If not passed, a one hour time frame is assumed for the log file.","format":"date-time","type":"string"},"start_time":{"description":"Start time for log file entries, in Unix time stamp format. Must not be more than 7 days in the past","format":"date-time","type":"string"},"zone_name":{"description":"The internationalized domain name representation (from RFC 3490) of the zone name","type":"string"}},"required":["start_time","zone_name"]},"ecdn_log_fetch_response":{"description":"Response object, providing the status of the current log fetch request.","properties":{"id":{"description":"ID of the log fetch request","type":"string"},"link":{"description":"HTTPS Download link to the fetched log file, which has a lifetime of 30 minutes. This link will only appear, if the current status of the log fetching is 'finished'.","type":"string"},"status":{"description":"Current status of the log fetch request","enum":["pending","running","finished"],"type":"string"}}},"filter":{"description":"Document representing a filter.\n "},"filtered_query":{"description":"A filtered query allows to filter the result of a (possibly complex) query using a (possibly complex) filter.\n ","properties":{"filter":{"$ref":"#/definitions/filter","description":"The (possibly complex) filter object.","x-sub_types":{"range_filter":"#/definitions/range_filter","bool_filter":"#/definitions/bool_filter","query_filter":"#/definitions/query_filter","term_filter":"#/definitions/term_filter","range2_filter":"#/definitions/range2_filter"}},"query":{"$ref":"#/definitions/query","description":"The query object.","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}}},"required":["filter","query"]},"functional_permission":{"description":"Document representing a functional permission.","properties":{"description":{"additionalProperties":{"type":"string"},"description":"The description of the functional permission.","format":"localized","type":"object"},"display_name":{"additionalProperties":{"type":"string"},"description":"The display name of the functional permission.","format":"localized","type":"object"},"name":{"description":"The name of the functional permission.","type":"string"},"type":{"description":"The permission type.","type":"string"},"values":{"description":"The list of possible values for the functional permission, e.g. ACCESS or READONLY.","items":{"type":"string"},"type":"array"}}},"functional_permissions":{"description":"Document representing the available functional permissions.","properties":{"organization":{"description":"The collection of available organization functional permissions.","items":{"$ref":"#/definitions/functional_permission"},"type":"array"},"scopes":{"description":"The available functional permission scopes (e.g. organization, site).","items":{"type":"string"},"type":"array"},"site":{"description":"The list of available site functional permissions.","items":{"$ref":"#/definitions/functional_permission"},"type":"array"}}},"gift_certificate":{"description":"Document representing a gift certificate","properties":{"amount":{"$ref":"#/definitions/money","description":"The gift certificate amount.\n The user cannot change the gift certificate amount after the creation of the gift certificate."},"balance":{"$ref":"#/definitions/money","description":"The gift certificate balance.\n This is a computed attribute and cannot be modified."},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"description":{"description":"The description of the gift certificate.","x-label":{"default":"Description"},"maxLength":4000,"type":"string"},"enabled":{"description":"The enabled flag of the gift certificate.","x-label":{"default":"Enabled"},"type":"boolean"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"The URL to get the gift certificate.\n This is a computed attribute and cannot be modified.","type":"string"},"masked_gift_certificate_code":{"description":"The masked gift certificate code with all but the\n last 4 characters replaced with a '*' character.\n This is a computed attribute and cannot be modified.","type":"string"},"merchant_id":{"description":"The merchant ID of the gift certificate.\n This is a unique attribute.\n This is a computed attribute and cannot be modified.\n This is used to get, update and the delete gift certificates.","x-label":{"default":"Merchant ID"},"type":"string"},"message":{"description":"The message to the recipient of the gift certificate.","x-label":{"default":"Message"},"maxLength":4000,"type":"string"},"order_no":{"description":"The order number of the gift certificate.","x-label":{"default":"Order Number"},"type":"string"},"recipient_email":{"description":"The email address of the recipient of the gift certificate.","x-label":{"default":"Recipient Email"},"type":"string"},"recipient_name":{"description":"The recipient of the gift certificate.","x-label":{"default":"Recipient Name"},"maxLength":256,"type":"string"},"sender_name":{"description":"The sender of the gift certificate.","x-label":{"default":"Sender Name"},"maxLength":256,"type":"string"},"status":{"description":"The status of the gift certificate.\n While creating a gift certificate, user can set the status\n to either \"pending\" or \"issued\" only.","enum":["issued","partially_redeemed","pending","redeemed"],"x-label":{"default":"Status"},"type":"string"},"transactions":{"description":"The transactions of the gift certificate","items":{"$ref":"#/definitions/account_transaction"},"type":"array"}}},"gift_certificate_search_result":{"description":"Document representing a gift certificate search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/gift_certificate"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"gift_certificates":{"description":"Document representing an unfiltered list of gift certificates.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/gift_certificate"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"image_group":{"description":"Document representing an image group containing a list of images for a particular view type and an optional variation value.","properties":{"images":{"description":"The images of the image group.","items":{"$ref":"#/definitions/media_file"},"type":"array"},"variation_attributes":{"description":"Returns a list of variation attributes applying to this image group.","items":{"$ref":"#/definitions/variation_attribute"},"type":"array"},"view_type":{"description":"The image view type.","type":"string"}}},"inventory_list":{"description":"Document representing a inventorylist","properties":{"assigned_sites":{"description":"The list of sites this inventory list is assigned to.  The assigned sites is a computed attribute, and cannot be\n directly modified.","items":{"type":"string"},"type":"array"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"default_in_stock":{"description":"True if the default for the inventory list is to be in stock. THe default value is false if not specified.","type":"boolean"},"description":{"description":"The user supplied description of this instance.","x-label":{"default":"Description"},"type":"string"},"id":{"description":"The id for the inventory list, which is required and must be unique.","x-label":{"default":"ID"},"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"URL that is used to get this instance.  The URL is a computed attribute, and cannot be modified.","type":"string"},"on_order_inventory_enabled":{"description":"True if the on order flag is enabled.  The default value is false if not specified.","type":"boolean"},"use_bundle_inventory_only":{"description":"True if the inventory list is used in bundle inventory only.  The default value is false if not specified.","type":"boolean"}}},"inventory_list_search_result":{"description":"Document representing a inventorylist search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/inventory_list"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"inventory_lists":{"description":"Document representing an unfiltered list of inventory lists.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/inventory_list"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"job_execution":{"properties":{"client_id":{"description":"When the execution was started by a client, this represents the client's id.","type":"string"},"duration":{"description":"Time in milliseconds, the job needed to be finished.","format":"int64","type":"integer"},"effective_duration":{"description":"Time in milliseconds, the job has done work. Paused times are evicted.","format":"int64","type":"integer"},"end_time":{"description":"Timestamp, when execution was finished.","format":"date-time","type":"string"},"execution_scopes":{"description":"Sorted set of all execution scopes, used by individual steps.","items":{"type":"string"},"type":"array"},"execution_status":{"description":"Current execution status. If the execution is running 'running' is returned. If the execution is pending\n 'pending' is returned. If the execution is finished 'finished' is returned.","enum":["pending","running","pausing","paused","resuming","resumed","restarting","restarted","aborting","aborted","finished"],"type":"string"},"exit_status":{"$ref":"#/definitions/status","description":"The exit status of the execution, if already finished."},"id":{"description":"ID of the execution object.","type":"string"},"is_log_file_existing":{"description":"True if the log file exists, otherwise false.","type":"boolean"},"is_restart":{"description":"True if this execution represents a job restart.","type":"boolean"},"job_description":{"description":"Description of the job, this execution belongs to.","type":"string"},"job_id":{"description":"ID of the job, this execution belongs to.","type":"string"},"log_file_name":{"description":"Name of the log file, containing execution log.","type":"string"},"modification_time":{"description":"Timestamp of the last modification time for the execution.","format":"date-time","type":"string"},"parameters":{"description":"List of all job execution parameters.","items":{"$ref":"#/definitions/job_execution_parameter"},"type":"array"},"start_time":{"description":"Timestamp, when execution was started.","format":"date-time","type":"string"},"status":{"description":"Current status. If the execution is running 'running' is returned. If the execution is pending 'pending' is\n returned. If the execution is finished the exit status code of the execution is returned.","type":"string"},"status_metadata":{"$ref":"#/definitions/status_metadata","description":"The metadata of the status."},"step_executions":{"description":"List of all steps, called for job execution.","items":{"$ref":"#/definitions/job_step_execution"},"type":"array"},"user_login":{"description":"When the execution was started by a registered user, this represents the user's login.","type":"string"}}},"job_execution_parameter":{"description":"Specification of a parameter for a job execution.","properties":{"name":{"description":"The name of the parameter.","maxLength":256,"minLength":1,"pattern":"\\S|(\\S(.*)\\S)","type":"string"},"value":{"description":"The value of the parameter.","maxLength":1000,"pattern":"\\S|(\\S(.*)\\S)","type":"string"}},"required":["name","value"]},"job_execution_request":{"description":"Specification of a parameter for a job execution.","properties":{"parameters":{"description":"","items":{"$ref":"#/definitions/job_execution_parameter"},"type":"array"}}},"job_execution_search_result":{"description":"Document representing a job search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. May be empty.","items":{"$ref":"#/definitions/job_execution"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"job_step_execution":{"properties":{"chunk_size":{"description":"The chunk size for a chunk oriented step execution, otherwise null.","format":"int32","type":"integer"},"duration":{"description":"Time in milliseconds, the job needed to be finished.","format":"int64","type":"integer"},"end_time":{"description":"Timestamp, when execution was finished.","format":"date-time","type":"string"},"execution_scope":{"description":"The ID of the scope this step is or was executed for.","type":"string"},"execution_status":{"description":"Current execution status. If the execution is running 'running' is returned. If the execution is pending\n 'pending' is returned. If the execution is finished 'finished' is returned.","enum":["pending","running","pausing","paused","resuming","resumed","restarting","restarted","aborting","aborted","finished"],"type":"string"},"exit_status":{"$ref":"#/definitions/status","description":"The exit status of the execution, if already finished."},"id":{"description":"ID of the execution object.","type":"string"},"include_steps_from_job_id":{"description":"ID of the job the step of this step execution was included from, if the step was included from another job.","type":"string"},"is_chunk_oriented":{"description":"True if this execution represents a chunk oriented step execution.","type":"boolean"},"item_filter_count":{"description":"The current number of items that have been filtered for a chunk oriented step execution, otherwise null.","format":"int32","type":"integer"},"item_write_count":{"description":"The current number of items that have been written for a chunk oriented step execution, otherwise null.","format":"int32","type":"integer"},"modification_time":{"description":"Timestamp of the last modification time for the execution.","format":"date-time","type":"string"},"start_time":{"description":"Timestamp, when execution was started.","format":"date-time","type":"string"},"status":{"description":"Current status. If the execution is running 'running' is returned. If the execution is pending 'pending' is\n returned. If the execution is finished the exit status code of the execution is returned.","type":"string"},"status_metadata":{"$ref":"#/definitions/status_metadata","description":"The metadata of the status."},"step_description":{"description":"Description of the step, this execution belongs to.ID of the step","type":"string"},"step_id":{"description":"ID of the step, this execution belongs to.ID of the step","type":"string"},"step_type_id":{"description":"ID of the step's type at the time it is or was executed.","type":"string"},"step_type_info":{"description":"Additional information regarding the step's type at the time it is or was executed (e.g. name of a script module\n and function).","type":"string"},"total_item_count":{"description":"The total number of items that will be processed for a chunk oriented step execution (null if unknown), otherwise\n null.","format":"int64","type":"integer"}}},"locale":{"description":"Document that describes a single locale.","properties":{"active":{"description":"Flag that is true if the locale is currently active in the system","type":"boolean"},"country":{"description":"The country/region code for this Locale, which will\n either be the empty string or an upercase ISO 3166 2-letter code.","type":"string"},"default":{"description":"Flag that is true if the locale is the default one to use if an explicit locale is not specified.","type":"boolean"},"display_country":{"description":"The name for the Locale's country that is appropriate for\n display to the user, or an empty string if no country has been specified\n for the Locale.\n The display country is returned in the language defined for this locale,\n and not in the language of the session locale.","type":"string"},"display_language":{"description":"The name for the Locale's language that is appropriate for\n display to the user, or an empty string if no language has been specified\n for the Locale.\n The display language is returned in the language defined for this locale,\n and not in the language of the session locale.","type":"string"},"display_name":{"description":"The name for the Locale that is appropriate for\n display to the user, or an empty string if no display name has been\n specified for the Locale.\n The display name is returned in the language defined for this locale,\n and not in the language of the session locale.","type":"string"},"id":{"description":"The identifier of the Locale. Contains a combination of the\n language and the country key, concatenated by \"-\", e.g. \"en-US\". This\n attribute is the primary key of the class.","type":"string"},"iso3_country":{"description":"The three-letter abbreviation for this Locale's country, or an\n empty string if no country has been specified for the Locale.","type":"string"},"iso3_language":{"description":"The three-letter abbreviation for this Locale's language, or an\n empty string if no language has been specified for the\n Locale.","type":"string"},"language":{"description":"The language code for this Locale, which will either\n be the empty string or a lowercase ISO 639 code.","type":"string"},"name":{"description":"The display name of the Locale. This uses the current\n request locale to localize the value.","type":"string"}}},"locale_permission":{"description":"Document representing a locale permission.","properties":{"display_name":{"additionalProperties":{"type":"string"},"description":"The display name of the locale.","format":"localized","type":"object"},"locale_id":{"description":"The id of the locale.","type":"string"},"type":{"description":"The permission type.","type":"string"},"values":{"description":"The list of possible values for the locale permission, e.g. ACCESS or READONLY.","items":{"type":"string"},"type":"array"}}},"locale_permissions":{"description":"Document representing the available locale permissions.","properties":{"scopes":{"description":"The available Locale permission scopes (e.g. unscoped).","items":{"type":"string"},"type":"array"},"unscoped":{"description":"The collection of available unscoped Locale permissions.","items":{"$ref":"#/definitions/locale_permission"},"type":"array"}}},"locale_result":{"description":"Contains the result of getting the system locales.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"hits":{"description":"The locales found by the request","items":{"$ref":"#/definitions/locale"},"type":"array"},"id":{"description":"The input locale (none specifies get all locales)","type":"string"},"include_all":{"description":"True to get the all the hits for all the locales, not just the active allowed ones","type":"boolean"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The string describing the set of fields to return in the result.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"log_category":{"description":"Document representing log category settings.","properties":{"enabled":{"description":"Returns true if the log category is enabled.","type":"boolean"},"level":{"description":"Level of the log category.","type":"string"},"name":{"description":"Log category name.","type":"string"}}},"markup_text":{"properties":{"markup":{"description":"The rendered HTML","type":"string"},"source":{"description":"The raw markup text","type":"string"}}},"master":{"properties":{"link":{"minLength":1,"type":"string"},"master_id":{"maxLength":100,"minLength":1,"type":"string"},"orderable":{"type":"boolean"},"price":{"format":"double","type":"number"},"price_max":{"format":"double","type":"number"},"price_per_unit":{"format":"double","type":"number"},"price_per_unit_max":{"format":"double","type":"number"},"prices":{"additionalProperties":{"format":"double","type":"number"},"type":"object"}},"required":["link","master_id"]},"match_all_query":{"description":"A match all query simply matches all documents (namespace and document type). This query comes in\n handy if you just want to filter a search result or really do not have any constraints.\n\n "},"media_file":{"properties":{"abs_url":{"description":"The absolute URL with request protocol","type":"string"},"alt":{"additionalProperties":{"type":"string"},"description":"The alternative image text","format":"localized","type":"object"},"dis_base_url":{"description":"The DIS base URL only for product images","type":"string"},"path":{"description":"The raw media file path","type":"string"},"title":{"additionalProperties":{"type":"string"},"description":"The image title","format":"localized","type":"object"}}},"menu_action":{"description":"Document representing a menu action.","properties":{"description":{"additionalProperties":{"type":"string"},"description":"The description of the menu action.","format":"localized","type":"object"},"display_name":{"additionalProperties":{"type":"string"},"description":"The display name of the menu action.","format":"localized","type":"object"},"module_type":{"description":"The module type of the menu action (BM or CC).","type":"string"},"name":{"description":"The name of the menu action.","type":"string"},"system":{"description":"{@code true} if the menu action is a system menu action. {@code false} if the menu action is a custom menu\n action.","type":"boolean"},"type":{"description":"The permission type.","type":"string"},"values":{"description":"The list of possible values for the menu action, e.g. ACCESS or READONLY.","items":{"type":"string"},"type":"array"}}},"menu_item":{"description":"Document representing a menu item.","properties":{"display_name":{"additionalProperties":{"type":"string"},"description":"The display name of the menu item.","format":"localized","type":"object"},"menu_actions":{"description":"The collection of available menu actions.","items":{"$ref":"#/definitions/menu_action"},"type":"array"},"module_type":{"description":"The module type of the menu item (BM or CC).","type":"string"},"name":{"description":"The name of the menu item.","type":"string"},"type":{"description":"The permission type.","type":"string"}}},"module_permissions":{"description":"Document representing the available module permissions in shape of menu items and menu actions.","properties":{"organization":{"description":"The collection of available organization menu items.","items":{"$ref":"#/definitions/menu_item"},"type":"array"},"scopes":{"description":"The available menu item scopes (e.g. organization, site).","items":{"type":"string"},"type":"array"},"site":{"description":"The list of available site menu items.","items":{"$ref":"#/definitions/menu_item"},"type":"array"}}},"money":{"properties":{"currency_mnemonic":{"description":"The mnemonic for the money.","type":"string"},"value":{"description":"The value for the money.","format":"double","type":"number"}}},"nested_query":{"description":"A nested query queries nested documents that are part of a larger document. The classical example is a\n product master with variants (in one big document) where you want to constrain a search to masters that have\n variants that match multiple constraints (like color = blue AND size = M).\n This query is not compatible with some search types. \n ","properties":{"path":{"description":"","type":"string"},"query":{"$ref":"#/definitions/query","description":"","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"score_mode":{"description":"","enum":["avg","total","max","none"],"type":"string"}},"required":["path","query"]},"object_attribute_definition":{"description":"Document representing a attribute definition","properties":{"default_value":{"$ref":"#/definitions/object_attribute_value_definition","description":"The default value of this attribute. It can be updated, but not created."},"description":{"additionalProperties":{"type":"string"},"description":"The localized description of the attribute.","format":"localized","type":"object"},"display_name":{"additionalProperties":{"type":"string"},"description":"The localized name presented to the user in forms.","format":"localized","type":"object"},"effective_id":{"description":"The effective ID, which is c_id if the attribute is custom, and just the id otherwise. It is read only.","type":"string"},"externally_defined":{"description":"Flag indicating if this attribute is externally defined.","type":"boolean"},"externally_managed":{"description":"Flag indicating if this attribute is externally managed.","type":"boolean"},"field_height":{"description":"The height of the field for this attribute in the editor.","format":"int32","type":"integer"},"field_length":{"description":"The length of the field for this attribute in the editor.","format":"int32","type":"integer"},"id":{"description":"The user supplied ID of the attribute.","type":"string"},"key":{"description":"Flag indicating if this is a key attribute.","type":"boolean"},"link":{"description":"The URL that is used to get this instance.  Value is computed and read-only.","type":"string"},"localizable":{"description":"Flag indicating if this attribute can be localized.","type":"boolean"},"mandatory":{"description":"Flag indicating if a value is mandatory for the attribute.","type":"boolean"},"max_value":{"description":"The maximum possible value for this attribute.","format":"double","type":"number"},"min_length":{"description":"The minimum length of the field for this attribute.","format":"int32","type":"integer"},"min_value":{"description":"The minimum possible value for this attribute.","format":"double","type":"number"},"multi_value_type":{"description":"True if the attribute can have multiple values.\n Attributes of the following types are multi-value capable:\n \n set_of_int\n set_of_number\n set_of_string\n \n Additionally, attributes of the following types can be multi-value\n enabled:\n \n enum_of_int\n enum_of_string\n ","type":"boolean"},"order_required":{"description":"Flag indicating if this attribute is required for order of the attribute model's product. The set of these can be used\n in order line items.","type":"boolean"},"queryable":{"description":"Returns true if the attribute definition is explicitly marked queryable. If no explicit queryable is found\n and the attribute value type belongs to a queryable type, true is returned too. In all other cases false is returned.\n Value is computed and read-only.","type":"boolean"},"read_only":{"description":"Flag indicating if this attribute is read-only. It is read only.","type":"boolean"},"regular_expression":{"description":"A regular expression that defines the legal values for this attribute.","type":"string"},"requires_encoding":{"description":"Flag indicating if this attribute can be encoded using the encoding=\"off\" flag in ISML templates. It is read only.","type":"boolean"},"scale":{"description":"The minimum number of fraction digits for a value of this attribute.","format":"int32","type":"integer"},"searchable":{"description":"Flag indicating if this attribute is searchable.","type":"boolean"},"set_value_type":{"description":"Flag indicating if this attribute is of type 'Set of'. It is read only.","type":"boolean"},"site_specific":{"description":"Flag indicating if this attribute is site-specific.","type":"boolean"},"system":{"description":"Flag indicating if this attribute is a system attribute.","type":"boolean"},"unit":{"additionalProperties":{"type":"string"},"description":"The unit of measure for this attribute.","format":"localized","type":"object"},"value_definitions":{"description":"A set of values that are possible for this attribute. It is read only.","items":{"$ref":"#/definitions/object_attribute_value_definition"},"type":"array"},"value_type":{"description":"The type of this attribute.","enum":["string","int","double","text","html","date","image","boolean","money","quantity","datetime","email","password","set_of_string","set_of_int","set_of_double","enum_of_string","enum_of_int","unknown"],"type":"string"},"visible":{"description":"Flag indicating if this attribute is visible.","type":"boolean"}}},"object_attribute_definition_search_result":{"description":"Document representing an attributedefinition search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/object_attribute_definition"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"object_attribute_definitions":{"description":"Document representing an unfiltered list of object attribute definitions.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/object_attribute_definition"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"object_attribute_group":{"description":"Document representing a attribute group","properties":{"attribute_definitions":{"description":"Attributes with the group displayed when expand=definition","items":{"$ref":"#/definitions/object_attribute_definition"},"type":"array"},"attribute_definitions_count":{"description":"The count of the attributes within the group.  This is a computed attribute and is read-only","format":"int32","type":"integer"},"description":{"additionalProperties":{"type":"string"},"description":"The free-form text description of the group by locale","format":"localized","type":"object"},"display_name":{"additionalProperties":{"type":"string"},"description":"The name used to display the group by locale.","format":"localized","type":"object"},"id":{"description":"The group's user specified identifier, used to retrieve the group","type":"string"},"internal":{"description":"True if the group is meant only for internal use, false otherwise.  This property is read-only.","type":"boolean"},"link":{"description":"URL that is used to get this instance.  This is a computed attribute and is read-only","type":"string"},"position":{"description":"The position of the group relative to other groups.","format":"double","minimum":0.0,"type":"number"}}},"object_attribute_group_search_result":{"description":"Document representing a attributegroup search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/object_attribute_group"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"object_attribute_groups":{"description":"Document representing an unfiltered list of object group definitions.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/object_attribute_group"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"object_attribute_value_definition":{"description":"Document representing a attribute definition","properties":{"description":{"additionalProperties":{"type":"string"},"description":"A description of the attribute value.","format":"localized","type":"object"},"display_value":{"additionalProperties":{"type":"string"},"description":"A display name that can be used to present this value in\n the user interface. For example, the value might be '1' but the display\n name might be 'Order Exported'.","format":"localized","type":"object"},"id":{"description":"The ID of the attribute value.","type":"string"},"position":{"description":"The position of the attribute value within the set of attribute values.","format":"double","type":"number"},"value":{"description":"The value of the attribute.","type":"object"}}},"object_type_definition":{"description":"Document representing a object type definition","properties":{"attribute_definition_count":{"description":"Returns the number of attribute definitions contained by the type.  This is a computed attribute and cannot be changed.","format":"int32","type":"integer"},"attribute_group_count":{"description":"Returns the number of attribute groups contained by the type.  This is a computed attribute and cannot be changed.","format":"int32","type":"integer"},"content_object":{"description":"True if the object type definition is marked as a content object","type":"boolean"},"description":{"additionalProperties":{"type":"string"},"description":"The user entered description for the type (localizable)","format":"localized","type":"object"},"display_name":{"additionalProperties":{"type":"string"},"description":"The user entered display name (localizable)","format":"localized","type":"object"},"link":{"description":"URL that is used to get this instance.  This is a computed attribute and cannot be changed.","type":"string"},"object_type":{"description":"The object type identifier","type":"string"},"queryable":{"description":"True if the system object type is queryable, false otherwise.  Default is true.","type":"boolean"},"read_only":{"description":"True if the system object is read-only, false otherwise.  This is a computed attribute and cannot be changed.","type":"boolean"}}},"object_type_definition_search_result":{"description":"Document representing a systemobject search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/object_type_definition"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"object_type_definitions":{"description":"Document representing an unfiltered list of system object types.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/object_type_definition"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"ocapi_configs_api_request":{"description":"OCAPI configuration APIs request","properties":{"resource_info":{"$ref":"#/definitions/resource_info","description":"Information of resources to be added"},"sites":{"description":"Sites to be updated","items":{"type":"string"},"type":"array"}},"required":["resource_info","sites"]},"ocapi_configs_api_response":{"description":"OCAPI configuration APIs response. It contains all available resources for a client","properties":{"global":{"description":"Global configuration","items":{"$ref":"#/definitions/site_resource_info"},"type":"array"},"sites":{"description":"Site configurations","items":{"$ref":"#/definitions/site_resource_info"},"type":"array"}}},"order_confirmation_status_update_request":{"description":"Request body to update the order confirmation status.","properties":{"status":{"description":"The new confirmation status for an order.","enum":["confirmed","not_confirmed"],"type":"string"}},"required":["status"]},"order_export_status_update_request":{"description":"Request body to update the order export status.","properties":{"status":{"description":"The new export status for an order.","enum":["exported","not_exported","ready","failed"],"type":"string"}},"required":["status"]},"order_external_status_update_request":{"description":"Request body to update the order external status.","properties":{"status":{"description":"The new external status for an order.","maxLength":256,"minLength":1,"type":"string"}},"required":["status"]},"order_payment_status_update_request":{"description":"Request body to update the order payment status.","properties":{"status":{"description":"The new payment status for an order.","enum":["paid","part_paid","not_paid"],"type":"string"}},"required":["status"]},"order_shipping_status_update_request":{"description":"Request body to update the order shipping status.","properties":{"status":{"description":"The new shipping status for an order.","enum":["shipped","part_shipped","not_shipped"],"type":"string"}},"required":["status"]},"order_status_update_request":{"description":"Request body to update the order status.","properties":{"status":{"description":"The new status for an order.","enum":["created","new","open","completed","cancelled","failed"],"type":"string"}},"required":["status"]},"order_update_request":{"description":"Request body to update an order."},"organization_preferences":{"description":"Represents a set of preferences attached at the organization level.","properties":{"link":{"description":"A URL that returns the full details for a custom preference","type":"string"},"site_preferences":{"description":"The list of site preferences, returned with expand=sites","items":{"$ref":"#/definitions/site_preferences"},"type":"array"}}},"password_change_request":{"properties":{"current_password":{"description":"The current user password","minLength":1,"type":"string"},"password":{"description":"The new user password","minLength":1,"type":"string"}},"required":["current_password","password"]},"path_record":{"description":"Document representing most basic info (id and name) of a category or catalog.","properties":{"id":{"description":"The id of the category path.","x-label":{"default":"ID"},"type":"string"},"name":{"additionalProperties":{"type":"string"},"description":"The name of the category path.","format":"localized","x-label":{"default":"Name"},"type":"object"}}},"payment_instrument_update_request":{"description":"Request body to update an order payment instrument."},"payment_transaction_update_request":{"description":"Request body to update an order payment transaction."},"preference_value":{"description":"Represents a single preference value","properties":{"attribute_definition":{"$ref":"#/definitions/object_attribute_definition","description":"The attribute definition for this preference"},"description":{"additionalProperties":{"type":"string"},"description":"Description of the attribute","format":"localized","type":"object"},"display_name":{"additionalProperties":{"type":"string"},"description":"Display name for the attribute","format":"localized","type":"object"},"id":{"description":"The id of the attribute","type":"string"},"site_values":{"additionalProperties":{"type":"object"},"description":"The value of this attribute","type":"object"},"value_type":{"description":"The type of this attribute.","enum":["string","int","double","text","html","date","image","boolean","money","quantity","datetime","email","password","set_of_string","set_of_int","set_of_double","enum_of_string","enum_of_int","unknown"],"type":"string"}}},"preference_value_search_result":{"description":"Document representing a preference value search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/preference_value"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"product":{"description":"Document representing a product","properties":{"assigned_categories":{"description":"The catalog categories that the product is assigned to","items":{"$ref":"#/definitions/catalog_category_id"},"type":"array"},"ats":{"description":"The ATS(Available To Sell) inventory value of the product. This is a calculated value.","format":"double","type":"number"},"brand":{"description":"The brand of the product.","x-label":{"default":"Brand"},"type":"string"},"bundled_products":{"description":"The array of bundled products which the product includes.","items":{"$ref":"#/definitions/product"},"type":"array"},"c_availableForInStorePickup":{"description":"Signals if there are inventory lists for brick-and-mortar stores associated with this product.","x-label":{"default":"Available for In Store Pickup"},"type":"boolean"},"c_batteryLife":{"x-label":{"default":"Battery Life"},"type":"string"},"c_batteryType":{"x-label":{"default":"Battery Type"},"type":"string"},"c_bootType":{"description":"Type of Boot for search refinement.","items":{"enum":["0010","0020","0030","0040","0050","0060","0070"],"x-enum-labels":[{"default":"Winter"},{"default":"Waterproof"},{"default":"Classic"},{"default":"Ankle & Mid"},{"default":"Tall"},{"default":"6\""},{"default":"Casual"}],"type":"string"},"x-label":{"default":"Boot Type"},"type":"array"},"c_bottomType":{"description":"Bottom type for search refinement","items":{"enum":["0010","0020","0030","0040","0050","0060","0070","0080"],"x-enum-labels":[{"default":"Khakis"},{"default":"Denim"},{"default":"Dress"},{"default":"Casual"},{"default":"Shorts"},{"default":"Work"},{"default":"Cargo"},{"default":"Fleece"}],"type":"string"},"x-label":{"default":"Bottom Type"},"type":"array"},"c_color":{"description":"Product color used for variation attribute","x-label":{"default":"Color"},"type":"string"},"c_consoleWarranty":{"x-label":{"default":"Extended Warranty"},"type":"string"},"c_customCSSFile":{"$ref":"#/definitions/media_file","description":"Use this attribute to apply custom styles for this product.","x-label":{"default":"Custom CSS File"}},"c_digitalCameraFeatures":{"items":{"enum":["0010","0020","0030","0040","0050","0060","0070","0080","0090","0100","0110","0120","0130","0140","0150","0160","0170","0180","0190","0200","0210","0220","0230","0240","0250","0260","0270","0280"],"x-enum-labels":[{"default":"Built In Flash"},{"default":"HD Video"},{"default":"GPS Geo Tagging"},{"default":"Variable Self Timer"},{"default":"Image Optimizer"},{"default":"Stop Motion Video"},{"default":"Self Cleaning"},{"default":"Pro Performance"},{"default":"51 Area Autofocus"},{"default":"Super Fast Startup"},{"default":"Easy to Learn"},{"default":"Wide Angle Optical Zoom"},{"default":"Manual Controls"},{"default":"Wired LAN"},{"default":"GPS Enabled"},{"default":"In Camera Red Eye Reduction"},{"default":"Large LCD"},{"default":"Optical Zoom"},{"default":"Anti-Shake"},{"default":"Touch Screen"},{"default":"Image Stabilization"},{"default":"Fast Shutter"},{"default":"Slim"},{"default":"35mm Full Frame Sensor"},{"default":"Wide Angle|Continuous Shooting"},{"default":"Continuous Shooting"},{"default":"ISO 1600"},{"default":"Red Eye Reduction"}],"type":"string"},"x-label":{"default":"Digital Camera Features"},"type":"array"},"c_digitalCameraPixels":{"x-label":{"default":"Digital Camera Pixels"},"type":"string"},"c_digitalCameraType":{"x-label":{"default":"Digital Camera Type"},"type":"string"},"c_digitalCameraWarranty":{"x-label":{"default":"Extended Warranty"},"type":"string"},"c_dimDepth":{"x-label":{"default":"Depth"},"type":"string"},"c_dimHeight":{"x-label":{"default":"Height"},"type":"string"},"c_dimWeight":{"x-label":{"default":"Weight"},"type":"string"},"c_dimWidth":{"x-label":{"default":"Width"},"type":"string"},"c_displaySize":{"x-label":{"default":"Display Size"},"type":"string"},"c_gameGenre":{"items":{"enum":["Action","Educational","Kids","Racing","Role-Playing","Sports","Strategy"],"x-enum-labels":[{"default":"Action"},{"default":"Educational"},{"default":"Kids"},{"default":"Racing"},{"default":"Role-Playing"},{"default":"Sports"},{"default":"Strategy"}],"type":"string"},"x-label":{"default":"Genre"},"type":"array"},"c_gameRating":{"x-label":{"default":"Game Rating"},"type":"string"},"c_gameSystemType":{"x-label":{"default":"Gaming System"},"type":"string"},"c_gpsFeatures":{"items":{"enum":["0010","0020","0030","0040","0050","0060","0070","0080","0090","0100","0110","0120","0130","0140","0150","0160","0170","0180","0190","0200","0210","0230"],"x-enum-labels":[{"default":"Preloaded"},{"default":"Voice Prompts"},{"default":"3D"},{"default":"Touch Screen"},{"default":"FM Traffic"},{"default":"MSN Direct"},{"default":"MP3 Player"},{"default":"Picture Viewer"},{"default":"Bluetooth®"},{"default":"Speech Recognition"},{"default":"XM Navtraffic"},{"default":"Waterproof"},{"default":"Motorcycle Ready"},{"default":"Lunar Tracking"},{"default":"Wrist Wear"},{"default":"Barometer"},{"default":"Compass"},{"default":"Geocaching"},{"default":"Jeppesen Enabled"},{"default":"Built-in HIS"},{"default":"Auto Logbook"},{"default":"Automotive Friendly"}],"type":"string"},"x-label":{"default":"GPS Features"},"type":"array"},"c_gpsType":{"items":{"enum":["0010","0020","0030","0040"],"x-enum-labels":[{"default":"Automotive"},{"default":"Personal"},{"default":"Outdoor"},{"default":"Aviation"}],"type":"string"},"x-label":{"default":"GPS Type"},"type":"array"},"c_gpsWarranty":{"x-label":{"default":"Extended Warranty"},"type":"string"},"c_imageAspectRatio":{"x-label":{"default":"Image Aspect Ratio"},"type":"string"},"c_isNew":{"x-label":{"default":"New Arrival?"},"type":"boolean"},"c_isNewtest":{"description":"This indiciates if the product is a new arrival.","x-label":{"default":"New Arrival?"},"type":"boolean"},"c_isSale":{"description":"This is the help text. It is used for sorting rules.","x-label":{"default":"On sale?"},"type":"boolean"},"c_kidsAge":{"description":"Kids Age used for search refinements","enum":["0010","0020","0030","0040","0050","0060","0070"],"x-enum-labels":[{"default":"Infant (0-1 yr)"},{"default":"Toddler (1-5 yrs)"},{"default":"Youth (5-9 yrs)"},{"default":"Junior (9-12 yrs)"},{"default":"Newborn (1-6 mths)"},{"default":"Infant (9 mnths - 3 yrs)"},{"default":"Junior (4-12 yrs)"}],"x-label":{"default":"Age"},"type":"string"},"c_length":{"description":"This attribute is used for mens and womens pants lengths.","x-label":{"default":"Length"},"type":"string"},"c_lensAperture":{"x-label":{"default":"Lens Aperture"},"type":"string"},"c_materialTest":{"items":{"enum":["cotton","wool","polyester"],"x-enum-labels":[{"default":"Cotton"},{"default":"Wool"},{"default":"Polyester"}],"type":"string"},"x-label":{"default":"Material"},"type":"array"},"c_mediaFormat":{"description":"Media Format","items":{"enum":["0010","0020","0030","0040","0050","0060","0070","0080","0090","0100"],"x-enum-labels":[{"default":"MP3"},{"default":"WMA"},{"default":"JPEG"},{"default":"WAV"},{"default":"FM Tuner"},{"default":"AAC"},{"default":"WMP"},{"default":"MPEG4"},{"default":"AVC"},{"default":"ASP"}],"type":"string"},"x-label":{"default":"Media Format"},"type":"array"},"c_memorySize":{"description":"Memory Size","x-label":{"default":"Memory Size"},"type":"string"},"c_memoryType":{"items":{"enum":["0010","0020","0030","0040","0050","0060","0070","0080","0090"],"x-enum-labels":[{"default":"SD"},{"default":"Memory Stick Pro DUO"},{"default":"Compact Flash"},{"default":"MMC"},{"default":"SDHC"},{"default":"CF Card"},{"default":"External Media"},{"default":"Micro SD"},{"default":"Garmin Data Card"}],"type":"string"},"x-label":{"default":"Memory Type"},"type":"array"},"c_musicStorage":{"x-label":{"default":"Music Storage"},"type":"string"},"c_opticalZoom":{"x-label":{"default":"Optical Zoom"},"type":"string"},"c_outerwearType":{"description":"Type of Outerwear for search refinement","enum":["0010","0020","0030","0040","0050","0060","0070","0080"],"x-enum-labels":[{"default":"Waterproof"},{"default":"Jackets"},{"default":"Vest"},{"default":"Pants"},{"default":"Casual"},{"default":"Sweater"},{"default":"Outdoor"},{"default":"Fleece"}],"x-label":{"default":"Outerwear Type"},"type":"string"},"c_portableAudioType":{"items":{"enum":["0010","0020","0030"],"x-enum-labels":[{"default":"Audio"},{"default":"Video"},{"default":"Internet"}],"type":"string"},"x-label":{"default":"Portable Audio Type"},"type":"array"},"c_refinementColor":{"enum":["black","blue","green","red","orange","pink","purple","white","yellow","grey","beige","miscellaneous","brown","navy"],"x-enum-labels":[{"default":"Black"},{"default":"Blue"},{"default":"Green"},{"default":"Red"},{"default":"Orange"},{"default":"Pink"},{"default":"Purple"},{"default":"White"},{"default":"Yellow"},{"default":"Grey"},{"default":"Beige"},{"default":"Miscellaneous"},{"default":"Brown"},{"default":"Navy"}],"x-label":{"default":"Refinement Color"},"type":"string"},"c_resolution":{"x-label":{"default":"Resolution"},"type":"string"},"c_sandalType":{"description":"Type of Sandal for search refinement","enum":["0010","0020","0030"],"x-enum-labels":[{"default":"Sport"},{"default":"Casual"},{"default":"Thong"}],"x-label":{"default":"Sandal Type"},"type":"string"},"c_sheets":{"description":"test attribute","items":{"enum":["value1","value2","value3"],"x-enum-labels":[{"default":"Value 1"},{"default":"Value 2"},{"default":"Value 3"}],"type":"string"},"x-label":{"default":"Sheets"},"type":"array"},"c_shoeType":{"description":"Type of Shoe for search refinements","enum":["0010","0020","0030","0040","0050","0060","0070","0080","0090","0100","0110"],"x-enum-labels":[{"default":"Chukka"},{"default":"Lace Up"},{"default":"Slip On"},{"default":"Clog"},{"default":"Boat"},{"default":"Oxford"},{"default":"Loafer"},{"default":"Waterproof"},{"default":"Flats"},{"default":"Ballerina"},{"default":"Heeled"}],"x-label":{"default":"Shoe Type"},"type":"string"},"c_size":{"description":"This attribute is used for all footwear, apparel and accessory sizing for men, women and kids products.","x-label":{"default":"Size"},"type":"string"},"c_skinConcern":{"items":{"enum":["dryTight","comprehensive","liftingLossFirm"],"x-enum-labels":[{"default":"Dry, Tight Skin"},{"default":"Comprehensive Protection"},{"default":"Lifting & Loss of Firmness"}],"type":"string"},"x-label":{"default":"Skin Concern"},"type":"array"},"c_styleNumber":{"x-label":{"default":"Style Number"},"type":"string"},"c_tabDescription":{"$ref":"#/definitions/markup_text","x-label":{"default":"Description"}},"c_tabDetails":{"$ref":"#/definitions/markup_text","x-label":{"default":"Details"}},"c_test":{"$ref":"#/definitions/markup_text","x-label":{"default":"test"}},"c_topType":{"description":"Type of tops in clothing","x-label":{"default":"Top Type"},"type":"string"},"c_tvSignalFormat":{"x-label":{"default":"TV Signal Format"},"type":"string"},"c_tvSize":{"x-label":{"default":"Size"},"type":"string"},"c_tvType":{"enum":["0010","0020","0030","0040"],"x-enum-labels":[{"default":"Plasma"},{"default":"LCD"},{"default":"DLP"},{"default":"Projection"}],"x-label":{"default":"TV Type"},"type":"string"},"c_tvWarranty":{"x-label":{"default":"Extended Warranty"},"type":"string"},"c_videoStorage":{"x-label":{"default":"Video Storage"},"type":"string"},"c_waist":{"description":"Attribute used for apparel waist sizing.","x-label":{"default":"Waist"},"type":"string"},"c_width":{"description":"This attribute is used for shoe widths for mens, womens and kids.","x-label":{"default":"Width"},"type":"string"},"classification_category":{"$ref":"#/definitions/catalog_category_id","description":"The classification category (default category) of the product"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"default_variant_id":{"description":"The ID of the product's default variant.","type":"string"},"ean":{"description":"The European Article Number of the product.","x-label":{"default":"EAN"},"type":"string"},"id":{"description":"The ID (SKU) of the product.","x-label":{"default":"ID","en":"SKUAGE"},"maxLength":100,"minLength":1,"type":"string"},"image":{"$ref":"#/definitions/media_file","description":"The image(s) assigned to the product.","x-label":{"default":"Standard Image"}},"image_groups":{"description":"The array of product image groups.","items":{"$ref":"#/definitions/image_group"},"type":"array"},"in_stock":{"description":"The flag that indicates if the product is in stock, or not. This is a calculated value.","type":"boolean"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"A link to the product.","type":"string"},"localized_tax_class_id":{"additionalProperties":{"type":"string"},"description":"","format":"localized","x-label":{"default":"Localized Tax Class"},"type":"object"},"long_description":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"description":"The localized long description of the product.","format":"localized","x-label":{"default":"Product Details"},"type":"object"},"manufacturer_name":{"description":"The name of the product's manufacturer.","x-label":{"default":"Manufacturer"},"type":"string"},"manufacturer_sku":{"description":"The SKU of the product's manufacturer.","x-label":{"default":"Manufacturer Product ID"},"type":"string"},"master":{"$ref":"#/definitions/master","description":"The master of the product. This is applicable for product types \"variation_group\" and \"variant\" only."},"name":{"additionalProperties":{"type":"string"},"description":"The localized name of the product.","format":"localized","x-label":{"default":"Name"},"type":"object"},"online":{"description":"The flag that indicates if the product is online, or not. This is a calculated value.","type":"boolean"},"online_flag":{"additionalProperties":{"type":"boolean"},"description":"The site specific online status of the product.","format":"site-specific","x-label":{"default":"Online"},"type":"object"},"owning_catalog_id":{"description":"The ID of the catalog that owns the product.","type":"string"},"owning_catalog_name":{"additionalProperties":{"type":"string"},"description":"The localized name of the catalog that owns the product.","format":"localized","type":"object"},"page_description":{"additionalProperties":{"type":"string"},"description":"The localized page description of the product.","format":"localized","x-label":{"default":"Page Description"},"type":"object"},"page_keywords":{"additionalProperties":{"type":"string"},"description":"The localized page keywords of the product.","format":"localized","x-label":{"default":"Page Keywords"},"type":"object"},"page_title":{"additionalProperties":{"type":"string"},"description":"The localized page title of the product.","format":"localized","x-label":{"default":"Page Title"},"type":"object"},"price":{"description":"The price of the product.","format":"double","type":"number"},"price_currency":{"description":"The currency code for product's price.","type":"string"},"price_per_unit":{"description":"The price per unit of the product","format":"double","type":"number"},"primary_categories":{"description":"The catalog categories that are primary for the product","items":{"$ref":"#/definitions/catalog_category_id"},"type":"array"},"primary_category_id":{"description":"The id of the products primary category.","type":"string"},"product_bundles":{"description":"The array of product bundles which the product belongs to.","items":{"$ref":"#/definitions/product"},"type":"array"},"product_options":{"description":"The array of product options. This is applicable for products of type \"option\".","items":{"$ref":"#/definitions/product_option"},"type":"array"},"product_sets":{"description":"The array of product sets which the product belongs to.","items":{"$ref":"#/definitions/product"},"type":"array"},"searchable":{"additionalProperties":{"type":"boolean"},"description":"The site specific searchable status of the product.","format":"site-specific","x-label":{"default":"Searchable"},"type":"object"},"set_products":{"description":"The array of set products which the product includes.","items":{"$ref":"#/definitions/product"},"type":"array"},"short_description":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"description":"The localized short description of the product.","format":"localized","x-label":{"default":"Description"},"type":"object"},"tax_class_id":{"description":"The catalog categories that the product is assigned to","x-label":{"default":"Tax Class"},"type":"string"},"type":{"$ref":"#/definitions/product_type","description":"The type of the product. It can have one or more of the values \"item\", \"master\", \"variation_group\", \"variant\", \"bundle\", and \"set\"."},"unit":{"description":"The sales unit of the product.","x-label":{"default":"Sales Unit"},"type":"string"},"unit_measure":{"description":"The unitMeasure of the product.","x-label":{"default":"Unit Measure"},"type":"string"},"unit_quantity":{"description":"The unitQuantity of the product.","format":"double","x-label":{"default":"Unit Quantity"},"type":"number"},"upc":{"description":"The Universal Product Code of the product.","x-label":{"default":"UPC"},"type":"string"},"valid_from":{"additionalProperties":{"format":"date-time","type":"string"},"description":"The time when product is valid from.","format":"site-specific","x-label":{"default":"Online From"},"type":"object"},"valid_to":{"additionalProperties":{"format":"date-time","type":"string"},"description":"The time when product is valid to.","format":"site-specific","x-label":{"default":"Online To"},"type":"object"},"variants":{"description":"The array of variants of the product. This is applicable for product types \"master\" and \"variation_group\" only.","items":{"$ref":"#/definitions/variant"},"type":"array"},"variation_attributes":{"description":"The sorted array of variation attributes assigned to the product. This is applicable for product types \"master\",\n \"variation_group\" and \"variant\" only.","items":{"$ref":"#/definitions/variation_attribute"},"type":"array"},"variation_groups":{"description":"The array of variation groups in the product. This is applicable for product type \"master\" only.","items":{"$ref":"#/definitions/variation_group"},"type":"array"},"variation_values":{"additionalProperties":{"type":"string"},"description":"The variation values selected for the product in variation attribute id and value pairs. This is applicable for product types \"variant\" and\n \"variation_group\" only.","type":"object"}}},"product_inventory_record":{"description":"Document representing a product inventory record.","properties":{"allocation":{"$ref":"#/definitions/product_inventory_record_allocation","description":"The allocation quantity and reset date."},"ats":{"description":"The quantity of items available to sell (ATS). This is calculated as the\n allocation plus the preorderBackorderAllocation minus the turnover.","format":"double","type":"number"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"in_stock_date":{"description":"The date that the item is expected to be in stock.","format":"date-time","type":"string"},"inventory_list_id":{"description":"The user supplied ID of the inventory list.","type":"string"},"inventory_turnover":{"description":"The sum of all inventory transactions (decrements and increments)\n that have been recorded subsequent to the allocation was reset date.\n The quantity value can be negative due to higher quantity of inventory decrements than increments.","format":"double","type":"number"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"The URL that is used to get this instance.","type":"string"},"perpetual_flag":{"description":"The flag that determines if the product is perpetually in stock.","type":"boolean"},"pre_order_back_order_allocation":{"description":"The quantity of items that are allocated for sale, beyond the initial stock allocation.","format":"double","type":"number"},"pre_order_back_order_handling":{"description":"The enum holding the records pre-backorder-handling configuration.\n Possible values are NONE, PREORDER and BACKORDER.\n Method returns NONE in case the record pre-backorder-handling-code is null or unknown.","enum":["none","preorder","backorder"],"type":"string"},"product_id":{"description":"The user supplied ID of the product.","maxLength":256,"minLength":1,"type":"string"},"product_name":{"description":"The name of the product.","type":"string"},"quantity_on_order":{"description":"The on order quantity, the quantity of all transactions for\n this record since the allocation reset date.","format":"double","type":"number"},"stock_level":{"description":"The current stock level. This is calculated as the allocation minus the turnover.","format":"double","type":"number"}}},"product_inventory_record_allocation":{"description":"Document representing a product inventory record allocation.","properties":{"amount":{"description":"The allocation quantity that is currently set. The quantity unit is the same unit as the product itself.","format":"double","type":"number"},"reset_date":{"description":"The date the allocation quantity was initialized or reset.","format":"date-time","type":"string"}}},"product_inventory_records":{"description":"Document representing an unfiltered list of inventory records.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"The collection of product inventory records.","items":{"$ref":"#/definitions/product_inventory_record"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"product_option":{"description":"Document representing a product option","properties":{"custom_name":{"additionalProperties":{"type":"string"},"description":"The localized custom name of the product option.","format":"localized","type":"object"},"default_product_option_value":{"description":"The default product option value.","type":"string"},"description":{"additionalProperties":{"type":"string"},"description":"The localized description of the product option.","format":"localized","type":"object"},"id":{"description":"The object attribute definition id which is also the identifier for the product option.","minLength":1,"type":"string"},"image":{"$ref":"#/definitions/media_file","description":"The image assigned to the product option."},"link":{"description":"The URL link to the product option.","type":"string"},"name":{"description":"The name of the object attribute definition.","type":"string"},"selected_option_value":{"description":"The selected option value of the product option.","type":"string"},"shared":{"description":"The flag that indicates if the product option is shared or local.","type":"boolean"},"sorting_mode":{"description":"The sorting mode for the product option values.","enum":["byexplicitorder","byoptionprice"],"type":"string"},"values":{"description":"The sorted array of values of the product option.","items":{"$ref":"#/definitions/product_option_value"},"type":"array"}}},"product_option_value":{"description":"Document representing a product option Value","properties":{"default_product_option_value":{"description":"Flag indicating if the product option value is the default value for the product option.","type":"boolean"},"id":{"description":"The id of the product option value.","minLength":1,"type":"string"},"link":{"description":"The URL link to the product option value.","type":"string"},"option_prices":{"description":"The list of prices in the product option value.","items":{"$ref":"#/definitions/money"},"type":"array"},"sku_extension":{"description":"The sku extension of the product option value.","type":"string"},"value":{"additionalProperties":{"type":"string"},"description":"The localized value of the product option.","format":"localized","type":"object"}}},"product_option_values":{"description":"Document representing an unfiltered list of product option values.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/product_option_value"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"product_options":{"description":"Document representing an unfiltered list of product options.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/product_option"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"product_search_result":{"description":"Document representing a product search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/product"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"product_type":{"description":"Document representing a product type.","properties":{"bundle":{"description":"A flag indicating whether the product is a bundle.","type":"boolean"},"bundled":{"description":"A flag indicating whether the product is bundled.","type":"boolean"},"item":{"description":"A flag indicating whether the product is a standard item.","type":"boolean"},"master":{"description":"A flag indicating whether the product is a master.","type":"boolean"},"option":{"description":"A flag indicating whether the product is an option.","type":"boolean"},"part_of_product_set":{"description":"A flag indicating whether the product is part of product set.","type":"boolean"},"part_of_retail_set":{"description":"A flag indicating whether the product is part of retail set.","type":"boolean"},"retail_set":{"description":"A flag indicating whether the product is a retail set.","type":"boolean"},"set":{"description":"A flag indicating whether the product is a set.","type":"boolean"},"variant":{"description":"A flag indicating whether the product is a variant.","type":"boolean"},"variation_group":{"description":"A flag indicating whether the product is a variation group.","type":"boolean"}}},"promotion":{"description":"Document representing a promotion. Unless otherwise stated, attributes of this document are not supported when using\n the Open Commerce API to update multiple promotions at once.","properties":{"archived":{"description":"Determines whether or not this promotion is archived. This attribute is allowed to be updated when using the Open\n Commerce API to update multiple promotions at once.","type":"boolean"},"assignment_information":{"$ref":"#/definitions/promotion_assignment_information","description":"Information about the assignments and assignment schedules of this promotion"},"callout_msg":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"description":"The localized callout message of the promotion.","format":"localized","x-label":{"default":"Callout Message"},"type":"object"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"currency_code":{"description":"The ISO 4217 mnemonic code of the currency this promotion is restricted to. If not populated, then there is no\n currency restriction on the promotion.","maxLength":3,"type":"string"},"disable_globally_excluded":{"description":"Determines whether or not this promotion ignores the global product exclusions for promotions.","type":"boolean"},"enabled":{"description":"Determines whether or not this promotion is enabled. This attribute is allowed to be updated when using the Open\n Commerce API to update multiple promotions at once.","type":"boolean"},"exclusivity":{"description":"Determines if the promotion can be combined with other promotions of the same promotion class or if it cannot be\n combined with any other promotions. This attribute is allowed to be updated when using the Open Commerce API to\n update multiple promotions at once.","enum":["no","class","global"],"x-enum-labels":[{"default":"Can be combined with any promotion."},{"default":"Can't be combined with promotions of the same class."},{"default":"Can't be combined with any promotion."}],"x-label":{"default":"Exclusivity"},"type":"string"},"id":{"description":"The id for the promotion.","x-label":{"default":"ID"},"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"A URL that is used to get the details of this promotion.","type":"string"},"name":{"additionalProperties":{"type":"string"},"description":"The user supplied name of this promotion, which can be localized","format":"localized","x-label":{"default":"Name"},"type":"object"},"promotion_class":{"description":"The class of the promotion. If the promotion class is modified, then the promotion rule and all of its values,\n such as whether or not to disable global product exclusions, will be reset.","enum":["product","shipping","order"],"type":"string"},"tags":{"description":"Returns the list of tags assigned to this promotion. If used to set the tags on a promotion, the promotion will\n only have the tags passed in the input. Any existing tags will be removed.","items":{"$ref":"#/definitions/tag"},"x-label":{"default":"Tags"},"type":"array"}}},"promotion_abtest_group_assignment":{"properties":{"abtest_description":{"type":"string"},"abtest_id":{"type":"string"},"enabled":{"type":"boolean"},"schedule":{"$ref":"#/definitions/schedule"},"segment_description":{"type":"string"},"segment_id":{"type":"string"}}},"promotion_assignment_information":{"properties":{"abtest_id":{"description":"If there is only one assignment, and that assignment is an A/B test segment, the id of the A/B test the segment\n belongs to. Otherwise, empty.","type":"string"},"abtest_segment_id":{"description":"If there is only one assignment, and that assignment is an A/B test segment, the id of the A/B test segment.\n Otherwise, empty.","type":"string"},"active":{"description":"true if the individual assignment or the multiple assignments are currently active.","type":"boolean"},"active_abtest_assignments":{"description":"A list of currently active A/B tests this is assigned to.","items":{"$ref":"#/definitions/promotion_abtest_group_assignment"},"type":"array"},"active_campaign_assignments":{"description":"A list of currently active campaigns this is assigned to.","items":{"$ref":"#/definitions/promotion_campaign_assignment"},"type":"array"},"campaign_id":{"description":"If there is only one assignment, and that assignment is a campaign, the id of the campaign. Otherwise, empty.","type":"string"},"enabled":{"type":"boolean"},"end_date":{"description":"The end date of the container of the assignment (a Campaign or ABTest). If schedule_type is\n schedule_type : \"multiple\" or schedule_type : \"none\", then then result will be null. Also, a null\n date will also return null.","format":"date-time","type":"string"},"schedule":{"$ref":"#/definitions/schedule","description":"The schedule of the assignment (a Campaign or ABTest). If schedule_type is\n schedule_type : \"multiple\" or schedule_type : \"none\", then then result will be null."},"schedule_type":{"description":"If there is only one active assignment, or no active assignments and one upcoming assignment, this is that type\n of assignment (schedule_type : \"campaign\" or schedule_type : \"abtest\"). If there are no\n assignments, it will be schedule_type : \"none\", otherwise, schedule_type : \"multiple\".","enum":["none","campaign","abtest","multiple"],"type":"string"},"start_date":{"description":"The start date of the container of the assignment (a Campaign or ABTest). If schedule_type is\n schedule_type : \"multiple\" or schedule_type : \"none\", then then result will be null. Also, a null\n date will also return null.","format":"date-time","type":"string"},"upcoming_abtest_assignments":{"description":"A list of upcoming A/B tests this is assigned to.","items":{"$ref":"#/definitions/promotion_abtest_group_assignment"},"type":"array"},"upcoming_campaign_assignments":{"description":"A list of upcoming campaigns this is assigned to.","items":{"$ref":"#/definitions/promotion_campaign_assignment"},"type":"array"}}},"promotion_campaign_assignment":{"description":"Document representing a promotion campaign assignment.","properties":{"campaign":{"$ref":"#/definitions/campaign","description":"The campaign"},"campaign_id":{"description":"The id of the campaign.","maxLength":256,"minLength":1,"type":"string"},"coupons":{"description":"The sorted array of assigned coupon ids.","items":{"type":"string"},"type":"array"},"customer_groups":{"description":"The sorted array of assigned customer groups.","items":{"type":"string"},"type":"array"},"description":{"description":"The description of the promotion campaign assignment.","maxLength":4000,"type":"string"},"enabled":{"description":"True if the assignment resource is enabled","type":"boolean"},"link":{"description":"link for convenience","type":"string"},"promotion":{"$ref":"#/definitions/promotion","description":"The promotion"},"promotion_id":{"description":"The id of the Promotion.","maxLength":256,"minLength":1,"type":"string"},"rank":{"description":"The rank of promotion campaign assignment","format":"int32","type":"integer"},"schedule":{"$ref":"#/definitions/schedule","description":"The schedule of the assignment resource"},"source_code_groups":{"description":"The sorted array of assigned source code groups.","items":{"type":"string"},"type":"array"}}},"promotion_campaign_assignment_search_result":{"description":"Document representing a promotion campaign assignment search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/promotion_campaign_assignment"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"promotion_search_result":{"description":"Document representing a promotion search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/promotion"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"promotions":{"description":"A set of promotions","properties":{"count":{"format":"int32","type":"integer"},"data":{"description":"The set of promotions","items":{"$ref":"#/definitions/promotion"},"type":"array"},"expand":{"items":{"type":"string"},"type":"array"},"next":{"type":"string"},"previous":{"type":"string"},"select":{"type":"string"},"start":{"format":"int32","minimum":0,"type":"integer"},"total":{"format":"int32","type":"integer"}}},"query":{"description":"Document representing a query. A query contains a set of objects that define criteria\n used to select records. A query can contain one of the following:\n"},"query_filter":{"description":"Document representing a query filter. A query filter wraps any query and allows it to be used as a filter.\n ","properties":{"query":{"$ref":"#/definitions/query","description":"The query to use as a filter.","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}}},"required":["query"]},"range2_filter":{"description":"Document representing a range compare with range filter, named Range2Filter.","properties":{"filter_mode":{"description":"Compare mode: overlap, containing, or contained. If not specified, the default is overlap.","enum":["overlap","containing","contained"],"type":"string"},"from_field":{"description":"The field name of the field that starts the first range.","type":"string"},"from_inclusive":{"description":"Indicates whether the lower bound of the second range is inclusive. If not specified, the default is true. Set to false to make the lower bound exclusive.","type":"boolean"},"from_value":{"description":"The lower bound of the second range. If not specified, the range is  open-ended with respect to the lower bound. You can't leave both the lower and upper bounds open-ended.","type":"object"},"to_field":{"description":"The field name of the field that ends the first range.","type":"string"},"to_inclusive":{"description":"Indicates whether the upper bound of the second range is inclusive. If not specified, the default is true. Set to false to make the lower bound exclusive.","type":"boolean"},"to_value":{"description":"The upper bound of the second range. If not specified, the range is  open-ended with respect to the upper bound. You can't leave both the upper and lower bounds open-ended.","type":"object"}},"required":["from_field","to_field"]},"range_filter":{"description":"Document representing a range filter.\n ","properties":{"field":{"description":"The search field.","type":"string"},"from":{"description":"The lower bound of the filter range. If not specified, the range is  open-ended with respect to the lower bound. You can't leave both the lower and upper bounds open-ended.","type":"object"},"from_inclusive":{"description":"Indicates whether the lower bound of the range is inclusive. If not specified, the default is true. Set to false to make the lower bound exclusive.","type":"boolean"},"to":{"description":"The upper bound of the filter range. If not specified, the range is  open-ended with respect to the upper bound. You can't leave both the upper and lower bounds open-ended.","type":"object"},"to_inclusive":{"description":"Indicates whether the upper bound of the range is inclusive. If not specified, the default is true. Set to false to made the upper bound  exclusive.","type":"boolean"}},"required":["field"]},"recommender":{"description":"The recommender object","properties":{"description":{"description":"The description of the recommender","type":"string"},"name":{"description":"The name of the recommender","type":"string"}}},"recommenders_result":{"description":"A list of recommenders available for use in recommendation requests.","properties":{"recommenders":{"description":"The recommender objects","items":{"$ref":"#/definitions/recommender"},"type":"array"}}},"recurrence":{"description":"Document representing a schedule recurrence.","properties":{"day_of_week":{"description":"The days of week for recurrence.","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"],"items":{"enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"],"type":"string"},"type":"array"},"time_of_day":{"$ref":"#/definitions/time_of_day","description":"The time of the day for recurrence."}}},"redemption_limit_per_period":{"description":"Document representing a coupon redemption limit.","properties":{"limit":{"description":"The limit on the number of times a coupon can be redeemed for a specified redemption time period.","format":"int32","minimum":0,"type":"integer"},"redemption_time_frame":{"description":"The redemption time period.","format":"int32","maximum":999,"minimum":0,"type":"integer"}}},"redemption_limits":{"description":"Document representing a coupon.","properties":{"limit_per_code":{"description":"The redemption limit per code","format":"int32","x-label":{"default":"Redemptions per Code"},"minimum":0,"type":"integer"},"limit_per_customer":{"description":"The redemption limit per customer","format":"int32","x-label":{"default":"Redemptions per Customer"},"minimum":0,"type":"integer"},"limit_per_time_frame":{"$ref":"#/definitions/redemption_limit_per_period","description":"The redemption limit per time frame","x-label":{"default":"Redemptions per Timeframe"}}}},"resource_info":{"properties":{"allowed_origins":{"description":"Allowed Origins","items":{"type":"string"},"type":"array"},"api_type":{"description":"API Type","enum":["data","shop"],"type":"string"},"resources":{"description":"An array of resources","items":{"$ref":"#/definitions/resource_object"},"minItems":1,"type":"array"},"response_headers":{"additionalProperties":{"type":"string"},"description":"Response Header","type":"object"}},"required":["api_type","resources"]},"resource_object":{"description":"Object to represent a resource in ocapi_config_api_request","properties":{"cache_time":{"description":"Resource Cache time","format":"int32","type":"integer"},"config":{"additionalProperties":{"type":"string"},"description":"Configuration of the resource","type":"object"},"methods":{"description":"Allowed methods of the resource","items":{"type":"string"},"minItems":1,"type":"array"},"personalized_caching_enabled":{"description":"Indicate if the personalized caching is enabled for the resource","type":"boolean"},"read_attributes":{"description":"Read attributes of the resource","type":"string"},"resource_id":{"description":"Resource ID","minLength":1,"type":"string"},"version_range":{"$ref":"#/definitions/version_range_object","description":"Version range"},"write_attributes":{"description":"Write attributes of the resource","type":"string"}},"required":["methods","resource_id"]},"result_page":{"description":"Data that can be used to get the next and previous page of a Data API results object.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","type":"integer"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","type":"integer"}}},"role":{"description":"Document representing an access role.","properties":{"description":{"description":"The role description.","type":"string"},"id":{"description":"The role ID.","type":"string"},"link":{"description":"URL that is used to get this instance.  This property is computed and cannot be modified.","type":"string"},"permissions":{"$ref":"#/definitions/role_permissions","description":"The permissions assigned to the access role. Available through expands."},"user_count":{"description":"Number of users assigned to the role.","format":"int32","type":"integer"},"user_manager":{"description":"Flag whether this role is allowed to manage users or other access roles.","type":"boolean"},"users":{"description":"The users assigned to the access role. Available through expands.","items":{"$ref":"#/definitions/user"},"type":"array"}}},"role_functional_permission":{"description":"Document representing a functional permission.","properties":{"name":{"description":"The name of the functional permission.","minLength":1,"type":"string"},"type":{"description":"The permission type (\"functional\").","minLength":1,"type":"string"},"value":{"description":"The non domain specific value for the functional permission, e.g. ACCESS or READONLY.","type":"string"},"values":{"additionalProperties":{"type":"string"},"description":"The map of value per domain for the functional permission, e.g. ACCESS or READONLY per domain name.","type":"object"}},"required":["name","type"]},"role_functional_permissions":{"description":"Document listing the functional permissions assigned to a certain role.","properties":{"organization":{"description":"The list of organization functional permissions.","items":{"$ref":"#/definitions/role_functional_permission"},"type":"array"},"site":{"description":"The list of site functional permissions.","items":{"$ref":"#/definitions/role_functional_permission"},"type":"array"}}},"role_locale_permission":{"description":"Document representing a locale permission.","properties":{"locale_id":{"description":"The related locale id of the locale permission.","minLength":1,"type":"string"},"type":{"description":"The permission type (\"locale\").","minLength":1,"type":"string"},"value":{"description":"The non domain specific value for the locale permission, e.g. ACCESS or READONLY.","type":"string"},"values":{"additionalProperties":{"type":"string"},"description":"The map of value per domain for the locale permission, e.g. ACCESS or READONLY per domain name.","type":"object"}},"required":["locale_id","type"]},"role_locale_permissions":{"description":"Document listing the locale permissions assigned to a certain role.","properties":{"unscoped":{"description":"The list of unscoped locale permissions.","items":{"$ref":"#/definitions/role_locale_permission"},"type":"array"}}},"role_module_permission":{"description":"Document representing a module permission.","properties":{"application":{"description":"The permission application (e.g. \"bm\", \"csc\").","minLength":1,"type":"string"},"name":{"description":"The related menu action name of the module permission.","minLength":1,"type":"string"},"system":{"description":"Flag to indicate a system menu action. This is false for custom menu actions.","type":"boolean"},"type":{"description":"The permission type (\"module\").","minLength":1,"type":"string"},"value":{"description":"The non domain specific value for the module permission, e.g. ACCESS or READONLY.","type":"string"},"values":{"additionalProperties":{"type":"string"},"description":"The map of value per domain for the module permission, e.g. ACCESS or READONLY per domain name.","type":"object"}},"required":["application","name","type"]},"role_module_permissions":{"description":"Document listing the module permissions assigned to a certain role.","properties":{"organization":{"description":"The list of organization module permissions.","items":{"$ref":"#/definitions/role_module_permission"},"type":"array"},"site":{"description":"The list of site module permissions.","items":{"$ref":"#/definitions/role_module_permission"},"type":"array"}}},"role_permissions":{"description":"Document listing the permissions assigned to a certain role (accessible by type).","properties":{"functional":{"$ref":"#/definitions/role_functional_permissions","description":"The functional permissions."},"locale":{"$ref":"#/definitions/role_locale_permissions","description":"The locale permissions."},"module":{"$ref":"#/definitions/role_module_permissions","description":"The module permissions."},"webdav":{"$ref":"#/definitions/role_webdav_permissions","description":"The WebDAV permissions."}}},"role_search_request":{"description":"Document representing an role search.\n\n Note that only either an user ID or a permission can be provided (or none), but not both. When one of them is provided,\n the further query elements will filter the respective role set (meaning the user ID / permission is AND-connected to the query definition).\n\n When a permission definition is using a site scope, it can contain only one site.\n\n When optional fields in the permission definitions are not provided, they will be treated as 'don't care' (so its e.g. possible so search for\n permission to site-specific BM modules without providing a site, and the search will return all roles having that permission for any site).","properties":{"count":{"description":"The number of returned documents","format":"int32","maximum":200,"minimum":1,"type":"integer"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"permissions":{"$ref":"#/definitions/role_permissions","description":"The permission to search for. Note that even though this is a container that can hold multiple permissions definitions,\n for a search request only one permission can be provided (otherwise an error will be returned)."},"query":{"$ref":"#/definitions/query","description":"The query to apply","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The field to be selected.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"user_id":{"description":"The id of the user whose roles are to be searched.","type":"string"}},"required":["query"]},"role_search_result":{"description":"Document representing an access role search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/role"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"role_webdav_permission":{"description":"Document representing a WebDAV permission.","properties":{"folder":{"description":"The related folder of the WebDAV permission.","minLength":1,"type":"string"},"type":{"description":"The permission type (\"webdav\").","minLength":1,"type":"string"},"value":{"description":"The non domain specific value for the WebDAV permission, e.g. ACCESS or READONLY.","type":"string"},"values":{"additionalProperties":{"type":"string"},"description":"The map of value per domain for the WebDAV permission, e.g. ACCESS or READONLY per domain name.","type":"object"}},"required":["folder","type"]},"role_webdav_permissions":{"description":"Document listing the WebDAV permissions assigned to a certain role.","properties":{"unscoped":{"description":"The list of unscoped WebDAV permissions.","items":{"$ref":"#/definitions/role_webdav_permission"},"type":"array"}}},"roles":{"description":"Document representing a list of access roles.","properties":{"count":{"format":"int32","type":"integer"},"data":{"description":"The list of access roles.","items":{"$ref":"#/definitions/role"},"type":"array"},"expand":{"items":{"type":"string"},"type":"array"},"next":{"type":"string"},"previous":{"type":"string"},"select":{"type":"string"},"start":{"format":"int32","minimum":0,"type":"integer"},"total":{"format":"int32","type":"integer"}}},"rule":{"description":"Document representing a customer group rule","properties":{"description":{"description":"The description of the rule, describing its conditions in natural language. Property is read-only.","type":"string"}}},"schedule":{"description":"Document representing a time schedule for slots.","properties":{"end_date":{"description":"The date to end of validity. ISO8601 date time format: yyyy-MM-dd'T'HH:mm:ssZ.","format":"date-time","type":"string"},"recurrence":{"$ref":"#/definitions/recurrence","description":"The recurrence of the schedule by day of week and time of day. Not all schedules will support a recurrence."},"start_date":{"description":"The date to start validity. ISO8601 date time format: yyyy-MM-dd'T'HH:mm:ssZ.","format":"date-time","type":"string"}}},"search_request":{"description":"Document representing a search request for retrieving items within the Data API. The query is a potentially complex set of expressions. The fields that each query supports are defined within the search resource.","properties":{"count":{"description":"The number of returned documents","format":"int32","maximum":200,"minimum":1,"type":"integer"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"query":{"$ref":"#/definitions/query","description":"The query to apply","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The field to be selected.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"}},"required":["query"]},"shipping_address_update_request":{"description":"Request body to update the order shipping address.","properties":{"address1":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"company_name":{"type":"string"},"country_code":{"type":"string"},"first_name":{"type":"string"},"full_name":{"x-label":{"default":"Full Name"},"type":"string"},"id":{"type":"string"},"job_title":{"type":"string"},"last_name":{"type":"string"},"phone":{"type":"string"},"post_box":{"type":"string"},"postal_code":{"type":"string"},"salutation":{"type":"string"},"second_name":{"type":"string"},"state_code":{"type":"string"},"suffix":{"type":"string"},"suite":{"type":"string"},"title":{"type":"string"}}},"site":{"description":"Document representing a site.","properties":{"cartridges":{"description":"The cartridge Path of the site","type":"string"},"customer_list_link":{"$ref":"#/definitions/customer_list_link","description":"The link to the customer list."},"description":{"additionalProperties":{"type":"string"},"description":"The description of this site.","format":"localized","type":"object"},"display_name":{"additionalProperties":{"type":"string"},"description":"The display name entered by the user.","format":"localized","type":"object"},"id":{"description":"The id of this site.","minLength":1,"type":"string"},"in_deletion":{"description":"The deletion status of this site, true if in deletion","type":"boolean"},"link":{"description":"A link directly to the site","type":"string"},"storefront_status":{"description":"","enum":["online","maintenance","to_be_deleted","protected"],"type":"string"}},"required":["id"]},"site_preferences":{"description":"Represents a set of preferences attached at the organization level.","properties":{"link":{"description":"A URL that returns the full details for a custom preference","type":"string"},"site":{"$ref":"#/definitions/site","description":"The site that contains the preferences"}}},"site_resource_info":{"description":"Object to represent a site configuration and available resources in the site configuration.","properties":{"site_configs":{"description":"Site configuration","items":{"$ref":"#/definitions/resource_info"},"type":"array"},"site_id":{"description":"Site ID","type":"string"}},"required":["site_configs"]},"site_search_result":{"description":"Document representing a site search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/site"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"sites":{"description":"Document representing an unfiltered list of sites.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/site"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"slot":{"description":"Document representing a slot","properties":{"context_type":{"description":"A slot context","enum":["global","category","folder"],"type":"string"},"description":{"description":"The user supplied description of the slot","maxLength":4000,"type":"string"},"link":{"description":"A link to the slot","type":"string"},"preview_url":{"description":"A preview URL the slot","type":"string"},"slot_configurations":{"description":"A list of slotconfigurations this slot has","items":{"$ref":"#/definitions/slot_configuration"},"type":"array"},"slot_id":{"description":"The id for the slot","maxLength":256,"minLength":1,"type":"string"}},"required":["slot_id"]},"slot_configuration":{"description":"Document representing a slot configuration.","properties":{"assignment_information":{"$ref":"#/definitions/slot_configuration_assignment_information","description":"Information about the assignments and assignment schedules of this slot configuration"},"callout_msg":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"description":"The call out message.","format":"localized","x-label":{"default":"Callout"},"type":"object"},"configuration_id":{"description":"The id of this configuration.","x-label":{"default":"ID"},"maxLength":256,"minLength":1,"type":"string"},"context":{"description":"The context of the slot. Ignored in input documents.","enum":["global","category","folder"],"type":"string"},"context_id":{"description":"When the context is category, this is a category_id; when\n the context is folder, this is a folder_id; and when the\n context is global, this is obsolete. This is ignored in input documents.","type":"string"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"customer_groups":{"description":"The customer groups ids.","items":{"type":"string"},"type":"array"},"default":{"description":"A flag indicating whether the configuration is the default one for the slot.","type":"boolean"},"description":{"description":"The configuration description.","maxLength":4000,"type":"string"},"enabled":{"description":"A flag indicating whether the slot is enabled.","type":"boolean"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"The link.","type":"string"},"rank":{"description":"The rank of the slot configuration on its slot. This rank has nothing to do with the rank\n on any campaign-assignment, because these are completely different objects. These must be\n updated separately.","enum":[10,20,30,40,50,60,70,80,90,100],"format":"int32","x-label":{"default":"Rank"},"minimum":1,"type":"integer"},"schedule":{"$ref":"#/definitions/schedule","description":"The schedule for the slot."},"slot_content":{"$ref":"#/definitions/slot_content","description":"The content of the slot."},"slot_id":{"description":"The ID of the slot. Ignored in input documents.","maxLength":256,"minLength":1,"type":"string"},"template":{"description":"The template.","maxLength":256,"type":"string"},"uuid":{"description":"The uuid of the slot configuration. This property cannot be written\n and is ignored in input documents.","x-label":{"default":"UUID"},"maxLength":28,"minLength":1,"readOnly":true,"type":"string"}},"required":["configuration_id","context","slot_content","slot_id"]},"slot_configuration_abtest_group_assignment":{"properties":{"abtest_description":{"type":"string"},"abtest_id":{"type":"string"},"enabled":{"type":"boolean"},"schedule":{"$ref":"#/definitions/schedule"},"segment_description":{"type":"string"},"segment_id":{"type":"string"}}},"slot_configuration_assignment_information":{"properties":{"abtest_id":{"description":"If there is only one assignment, and that assignment is an A/B test segment, the id of the A/B test the segment\n belongs to. Otherwise, empty.","type":"string"},"abtest_segment_id":{"description":"If there is only one assignment, and that assignment is an A/B test segment, the id of the A/B test segment.\n Otherwise, empty.","type":"string"},"active":{"description":"true if the individual assignment or the multiple assignments are currently active.","type":"boolean"},"active_abtest_assignments":{"description":"A list of currently active A/B tests this is assigned to.","items":{"$ref":"#/definitions/slot_configuration_abtest_group_assignment"},"type":"array"},"active_campaign_assignments":{"description":"A list of currently active campaigns this is assigned to.","items":{"$ref":"#/definitions/slot_configuration_campaign_assignment"},"type":"array"},"campaign_id":{"description":"If there is only one assignment, and that assignment is a campaign, the id of the campaign. Otherwise, empty.","type":"string"},"enabled":{"type":"boolean"},"end_date":{"description":"The end date of the container of the assignment (a Campaign or ABTest). If schedule_type is\n schedule_type : \"multiple\" or schedule_type : \"none\", then then result will be null. Also, a null\n date will also return null.","format":"date-time","type":"string"},"schedule":{"$ref":"#/definitions/schedule","description":"The schedule of the assignment (a Campaign or ABTest). If schedule_type is\n schedule_type : \"multiple\" or schedule_type : \"none\", then then result will be null."},"schedule_type":{"description":"If there is only one active assignment, or no active assignments and one upcoming assignment, this is that type\n of assignment (schedule_type : \"campaign\" or schedule_type : \"abtest\"). If there are no\n assignments, it will be schedule_type : \"none\", otherwise, schedule_type : \"multiple\".","enum":["none","campaign","abtest","multiple"],"type":"string"},"start_date":{"description":"The start date of the container of the assignment (a Campaign or ABTest). If schedule_type is\n schedule_type : \"multiple\" or schedule_type : \"none\", then then result will be null. Also, a null\n date will also return null.","format":"date-time","type":"string"},"upcoming_abtest_assignments":{"description":"A list of upcoming A/B tests this is assigned to.","items":{"$ref":"#/definitions/slot_configuration_abtest_group_assignment"},"type":"array"},"upcoming_campaign_assignments":{"description":"A list of upcoming campaigns this is assigned to.","items":{"$ref":"#/definitions/slot_configuration_campaign_assignment"},"type":"array"}}},"slot_configuration_campaign_assignment":{"description":"Document representing a slot_configuration_campaign_assignment","properties":{"campaign":{"$ref":"#/definitions/campaign","description":"The campaign."},"campaign_id":{"description":"The id of the campaign that has the slot configuration assigned to it.","maxLength":256,"minLength":1,"type":"string"},"context":{"description":"The slot context.","enum":["global","category","folder"],"type":"string"},"customer_groups":{"description":"The list of customer groups.","items":{"type":"string"},"type":"array"},"description":{"description":"The description of the slot configuration.","maxLength":4000,"type":"string"},"enabled":{"description":"True if the assignment resource is enabled","type":"boolean"},"link":{"description":"The URL to the slot configuration-campaign assignment.","type":"string"},"rank":{"description":"The rank of the slot confiuration-campaign assignment.\n This is different than the rank of the slot configuration.","format":"int32","minimum":1,"type":"integer"},"schedule":{"$ref":"#/definitions/schedule","description":"The schedule of the assignment resource"},"slot_configuration":{"$ref":"#/definitions/slot_configuration","description":"The slotConfiguration"},"slot_configuration_id":{"description":"The ID of the slot configuration.","maxLength":256,"minLength":1,"type":"string"},"slot_configuration_uuid":{"description":"The UUID of the slot configuration.","maxLength":28,"type":"string"},"slot_context_id":{"description":"The ID of the slot's context, for example, the category ID for a slot with category context.","maxLength":256,"type":"string"},"slot_id":{"description":"The ID of the slot.","maxLength":256,"minLength":1,"type":"string"}},"required":["context","slot_configuration_id","slot_id"]},"slot_configuration_campaign_assignment_search_result":{"properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/slot_configuration_campaign_assignment"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"slot_configuration_search_result":{"description":"Document representing a slot configuration search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. This array can be empty.","items":{"$ref":"#/definitions/slot_configuration"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"slot_configurations":{"description":"Document representing an unfiltered list of slot configurations.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/slot_configuration"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"slot_content":{"description":"Document representing the content type for a slot.","properties":{"body":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"description":"The HTML body (valid only for type 'html').","format":"localized","type":"object"},"category_ids":{"description":"The category ids (valid only for type 'categories').","items":{"type":"string"},"type":"array"},"content_asset_ids":{"description":"The content asset ids (valid only for type 'content_assets').","items":{"type":"string"},"type":"array"},"product_ids":{"description":"The product ids (valid only for type 'products').","items":{"type":"string"},"type":"array"},"type":{"description":"The type of content in the slot.","enum":["products","categories","content_assets","html","recommended_products"],"type":"string"}},"required":["type"]},"slot_search_result":{"description":"Document representing a slot search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/slot"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"slots":{"description":"Document representing an unfiltered list of slots.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/slot"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"sort":{"description":"Document representing a sort request.","properties":{"field":{"description":"The name of the field to sort on.","type":"string"},"sort_order":{"description":"The sort order to be applied when sorting. When omitted, the default sort order (ASC) is used.","enum":["asc","desc"],"type":"string"}},"required":["field"]},"sorting_rule":{"description":"Document representing a product sorting rule","properties":{"creation_date":{"description":"The creation date, read only","format":"date-time","type":"string"},"description":{"description":"The description of the product sorting rule.","maxLength":4000,"type":"string"},"id":{"description":"the id of product sorting rule.","type":"string"},"product_sorting_rule_steps":{"description":"the steps involved in sorting by this rule.","items":{"$ref":"#/definitions/sorting_rule_step"},"type":"array"},"rule_context":{"description":"The context of the rule, either site or global","type":"string"},"site":{"description":"","type":"string"}}},"sorting_rule_search_result":{"description":"Document representing a source code group search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/sorting_rule"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"sorting_rule_step":{"description":"Document representing a product sorting rule step","properties":{"attribute_id":{"description":"the id for sorting attribute.","type":"string"},"direction":{"description":"the direction of the sorting attribute","enum":["asc","desc"],"type":"string"},"is_system":{"description":"whether or not the attribute is a system attribute.","type":"boolean"},"position":{"description":"the position of product sorting rule step.","format":"int32","type":"integer"},"text_relevance_included":{"description":"The text relevance included.","type":"boolean"},"type_id":{"description":"the sorting type for sorting attribute.","type":"string"}}},"source_code_group":{"description":"Document representing a source code group","properties":{"active":{"description":"The active flag, a computed value based on start and end time","type":"boolean"},"active_redirect":{"$ref":"#/definitions/source_code_redirect_info","description":"The active redirect information"},"cookie_duration":{"description":"The cookie duration in days","format":"int32","maximum":999,"minimum":0,"type":"integer"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"description":{"description":"The description","type":"string"},"enabled":{"description":"The enabled flag for storefront to consider the source code group, default to false.","type":"boolean"},"end_time":{"description":"The end time","format":"date-time","type":"string"},"id":{"description":"The id of source code group","x-label":{"default":"ID"},"maxLength":28,"minLength":1,"type":"string"},"inactive_redirect":{"$ref":"#/definitions/source_code_redirect_info","description":"The inactive redirect information"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"link":{"description":"URL that is used to get this instance, read only","type":"string"},"specifications":{"description":"Source Code specifications","items":{"$ref":"#/definitions/source_code_specification"},"type":"array"},"start_time":{"description":"The start time","format":"date-time","type":"string"}}},"source_code_group_search_result":{"description":"Document representing a source code group search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/source_code_group"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"source_code_groups":{"description":"Document representing an unfiltered list of source code groups.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/source_code_group"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"source_code_redirect_info":{"description":"Document representing a source code redirect info","properties":{"location":{"description":"The location of redirect, based on the type, this can be a product location, category location, home page, content page, or just a URL","type":"string"},"location_type":{"description":"The type of redirect location, e.g. product (for a product page), category (a category page), home (for home page), page (for content), url (for a URL location)","enum":["default","home","product","category","page","url"],"type":"string"}}},"source_code_specification":{"description":"Document representing a source code specification","properties":{"expression":{"description":"Expression is a value for the \"Source Code Specification\" may be a literal source code, or it may contain wildcards.\n A literal code is simply the literal code. Valid characters are letters and numbers (no spaces).\n A wildcard allows a single source code specification to match multiple source codes. The following wildcards are supported:\n ? - Matches any single alpha-numeric character. For example: the source code specification 'ABC?' would match 'ABCD' or 'ABC3', but not 'ABCDE'.\n * - Matches any sequence of alpha-numeric characters. For example: the source code specification 'ABC*' would match 'ABCD', 'ABCDE', or 'ABC123'.\n [n1..n2] - Matches any number from n1 through and including n2.\n For example: the source code specification 'ABC[3..22]' would match 'ABC3', 'ABC4' or 'ABC22', but not 'ABC33' or 'ABCD'.","type":"string"}}},"status":{"properties":{"code":{"description":"Status code.","type":"string"},"message":{"description":"Status message.","type":"string"},"status":{"description":"Status shows successful operation end.","enum":["ok","error"],"type":"string"}}},"status_metadata":{"properties":{"client_id":{"description":"The client ID that is responsible for the status.","type":"string"},"reason":{"description":"The reason of the status.","type":"string"},"user_login":{"description":"The user login that is responsible for the status.","type":"string"}}},"store":{"description":"Document representing a store","properties":{"address1":{"description":"Returns the first address.","x-label":{"default":"Address 1"},"maxLength":256,"type":"string"},"address2":{"description":"Returns the second address value.","x-label":{"default":"Address 2"},"maxLength":256,"type":"string"},"c_TestAttribute":{"items":{"type":"string"},"x-label":{"en-US":"Test Attribute"},"type":"array"},"c_countryCodeValue":{"description":"Country Code Value - for the form values","x-label":{"default":"Country Code Value"},"type":"string"},"c_inventoryListId":{"description":"Store Inventory List ID","x-label":{"default":"Store Inventory List ID"},"type":"string"},"city":{"description":"Returns the city.","x-label":{"default":"City"},"maxLength":256,"type":"string"},"country_code":{"description":"The two-character country code per ISO 3166-1 alpha-2.","enum":["US","CA","DE"],"x-enum-labels":[{"default":"United States"},{"default":"Canada"},{"default":"Germany"}],"x-label":{"default":"Country"},"maxLength":2,"type":"string"},"creation_date":{"description":"Returns the value of attribute 'creationDate'.","format":"date-time","x-label":{"default":"Creation Date"},"readOnly":true,"type":"string"},"email":{"description":"Email address to contact the store","x-label":{"default":"Email"},"maxLength":256,"type":"string"},"fax":{"description":"Returns the fax number .","x-label":{"default":"Fax"},"maxLength":256,"type":"string"},"id":{"description":"The id for the store","x-label":{"default":"ID"},"maxLength":256,"type":"string"},"image":{"$ref":"#/definitions/media_file","description":"The image associated with the store","x-label":{"default":"Image"}},"inventory_id":{"description":"The inventory list associated with the store","x-label":{"default":"Inventory List"},"maxLength":256,"type":"string"},"last_modified":{"description":"Returns the value of attribute 'lastModified'.","format":"date-time","x-label":{"default":"Last Modified"},"readOnly":true,"type":"string"},"latitude":{"description":"The latitude of the store","format":"double","x-label":{"default":"Latitude"},"maximum":90.0,"minimum":-90.0,"type":"number"},"link":{"description":"a URL that is used to get this instance.  The property is computed and cannot be changed.","x-label":{"default":"Store document link"},"type":"string"},"longitude":{"description":"The longitude of the store","format":"double","x-label":{"default":"Longitude"},"maximum":180.0,"minimum":-180.0,"type":"number"},"name":{"description":"The name of the store","x-label":{"default":"Name"},"type":"string"},"phone":{"description":"Returns the phone number.","x-label":{"default":"Phone"},"maxLength":256,"type":"string"},"pos_enabled":{"description":"Whether this store uses our Store product for Point-of-Sale","x-label":{"default":"Uses Commerce Cloud Store for Point-of-Sale"},"type":"boolean"},"postal_code":{"description":"The postal code for the store","x-label":{"default":"Postal Code"},"maxLength":10,"type":"string"},"state_code":{"description":"Returns the customer's state.","x-label":{"default":"State"},"maxLength":256,"type":"string"},"store_events":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"description":"The store events (localized)","format":"localized","x-label":{"default":"Store Events"},"type":"object"},"store_hours":{"additionalProperties":{"$ref":"#/definitions/markup_text"},"description":"The store opening hours (localized)","format":"localized","x-label":{"default":"Store Hours"},"type":"object"},"store_locator_enabled":{"description":"Whether this store should appear in store locator searches","x-label":{"default":"Store Locator Enabled"},"type":"boolean"}}},"store_search_result":{"description":"Document representing a store search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/store"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"stores":{"description":"Document representing an unfiltered list of stores.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/store"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"tag":{"description":"Document representing a tag","properties":{"tag_id":{"description":"The id of the tag.","type":"string"}}},"term_filter":{"description":"Document representing a term filter.\n ","properties":{"field":{"description":"The filter field.","type":"string"},"operator":{"description":"The operator to compare the field's values with the given ones.","enum":["is","one_of","is_null","is_not_null","less","greater","not_in","neq"],"type":"string"},"values":{"description":"The filter values.","items":{"type":"object"},"type":"array"}},"required":["field","operator"]},"term_query":{"description":"A term query matches one (or more) value(s) against one (or more) document field(s). A document is considered a hit\n if one of the values matches (exactly) with at least one of the given fields.  The operator \"is\" can only take\n one value, while \"one_of\" can take multiple values. If multiple fields are specified, they are combined using the OR operator.\n The ","properties":{"fields":{"description":"The document field(s), the value(s) are matched against, combined with the operator.","items":{"type":"string"},"minItems":1,"type":"array"},"operator":{"description":"Returns the operator to use for the term query.","enum":["is","one_of","is_null","is_not_null","less","greater","not_in","neq"],"type":"string"},"values":{"description":"The values, the field(s) are compared against, combined with the operator.","items":{"type":"object"},"type":"array"}},"required":["fields","operator"]},"text_query":{"description":"A text query is used to match some text (i.e. a search phrase possibly consisting of multiple terms) against one or\n multiple fields. In case multiple fields are provided, the phrase conceptually forms a logical OR over the fields. In\n this case, the terms of the phrase basically have to match within the text, that would result in concatenating all\n given fields.\n ","properties":{"fields":{"description":"The document fields the search phrase has to match against.","items":{"type":"string"},"minItems":1,"type":"array"},"search_phrase":{"description":"A search phrase, which may consist of multiple terms.","type":"string"}},"required":["fields","search_phrase"]},"time_of_day":{"description":"Document representing a time schedule within a single day.","properties":{"time_from":{"description":"The time to start from. Time format: HH:mm:ss. Seconds\n are ignored and set to 0.","format":"time","type":"string"},"time_to":{"description":"The time to end on. Time format: HH:mm:ss. Seconds\n are ignored and set to 0.","format":"time","type":"string"}}},"user":{"description":"Document representing a user.","properties":{"disabled":{"description":"Flag whether the user is disabled.","type":"boolean"},"email":{"description":"The email address.","maxLength":256,"type":"string"},"external_id":{"description":"The external id. This attribute is only valid when the user uses centralized authentication.","maxLength":256,"type":"string"},"first_name":{"description":"The first name.","maxLength":256,"type":"string"},"last_login_date":{"description":"Last login of the user.","format":"date","type":"string"},"last_name":{"description":"The last name.","maxLength":256,"type":"string"},"link":{"description":"URL that is used to get this instance.  This property is computed and cannot be modified.","type":"string"},"locked":{"description":"Flag whether the user is locked.","type":"boolean"},"login":{"description":"The user login.","maxLength":256,"type":"string"},"password":{"description":"The password. This attribute is only used to set the password upon user creation.\n This attribute is only valid when the user does not use centralized authentication.","type":"string"},"password_expiration_date":{"description":"The user password expiration time","format":"date-time","type":"string"},"password_modification_date":{"description":"The time, where the password was last modified","format":"date-time","type":"string"},"preferred_data_locale":{"description":"The effective preferred data locale of the user. A locale is only considered if the user has at least read\n permission on the locale.","type":"string"},"preferred_ui_locale":{"description":"The preferred UI locale of the user.","type":"string"},"roles":{"description":"List of role ids the user is assigned to.","items":{"type":"string"},"type":"array"}},"required":["email","last_name"]},"user_search_result":{"description":"Document representing an user search result.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The sorted array of search hits. Can be empty.","items":{"$ref":"#/definitions/user"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"users":{"description":"Document representing a list of users.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"The list of users.","items":{"$ref":"#/definitions/user"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"variant":{"description":"Document representing a product variation.","properties":{"ats":{"description":"Inventory \"Available to Sell\" of the product.","format":"double","type":"number"},"default_product_variation":{"description":"","type":"boolean"},"image":{"$ref":"#/definitions/media_file","description":"URL to the preview image."},"in_stock":{"description":"true if the product is in stock, or false if not.","type":"boolean"},"link":{"description":"The URL addressing the product.","type":"string"},"online":{"description":"If the product is currently online.\n true if online\n false if not","type":"boolean"},"orderable":{"description":"A flag indicating whether the variant is orderable.","type":"boolean"},"price":{"description":"The sales price of the variant.","format":"double","type":"number"},"price_currency":{"description":"Currency code for the price of the product.","type":"string"},"price_per_unit":{"description":"The sales price of the variant.","format":"double","type":"number"},"product_id":{"description":"The id (SKU) of the variant.","maxLength":100,"minLength":1,"type":"string"},"searchable":{"additionalProperties":{"type":"boolean"},"description":"","format":"site-specific","type":"object"},"variation_attributes":{"description":"variation attributes","items":{"$ref":"#/definitions/variation_attribute"},"type":"array"},"variation_values":{"additionalProperties":{"type":"string"},"description":"The actual variation attribute id - value pairs.","type":"object"}},"required":["product_id"]},"variant_search_result":{"description":"Document that represents a search on certificates and keys.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"db_start_record_":{"description":"The zero-based index of the record that we want to start with, used to optimize special handling","format":"int32","minimum":0,"type":"integer"},"expand":{"description":"List of expansions to be applied to each search results. Expands are optional","items":{"type":"string"},"type":"array"},"hits":{"description":"The hits from the search","items":{"$ref":"#/definitions/variant"},"type":"array"},"next":{"$ref":"#/definitions/result_page","description":"The URL of the next result page."},"previous":{"$ref":"#/definitions/result_page","description":"The URL of the previous result page."},"query":{"$ref":"#/definitions/query","description":"The query passed into the search","x-sub_types":{"nested_query":"#/definitions/nested_query","filtered_query":"#/definitions/filtered_query","text_query":"#/definitions/text_query","match_all_query":"#/definitions/match_all_query","term_query":"#/definitions/term_query","bool_query":"#/definitions/bool_query"}},"select":{"description":"The fields that you want to select.","type":"string"},"sorts":{"description":"The list of sort clauses configured for the search request. Sort clauses are optional.","items":{"$ref":"#/definitions/sort"},"type":"array"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"variants":{"description":"Document representing an unfiltered list of variants.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/variant"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"variation_attribute":{"description":"Document representing a variation attribute.","properties":{"attribute_definition_id":{"description":"The id of the requested attribute definition.","type":"string"},"attribute_definition_name":{"additionalProperties":{"type":"string"},"description":"The localized display name of the variation attribute definition.","format":"localized","type":"object"},"default_value":{"description":"default variation attribute value","type":"string"},"id":{"description":"The id of the variation attribute.","minLength":1,"type":"string"},"link":{"description":"URL that is used to get this instance","type":"string"},"name":{"additionalProperties":{"type":"string"},"description":"The localized display name of the variation attribute.","format":"localized","type":"object"},"shared":{"description":"Returns the value of attribute 'shared' if attribute is local or shared","type":"boolean"},"slicing":{"description":"Returns the value of attribute 'slicing'.","type":"boolean"},"values":{"description":"The sorted array of variation values. This array can be empty.","items":{"$ref":"#/definitions/variation_attribute_value"},"type":"array"},"variation_attribute_type":{"description":"variation attribute type","enum":["string","int","unknown"],"type":"string"}},"required":["attribute_definition_id"]},"variation_attribute_value":{"description":"Document representing a variation attribute value.","properties":{"description":{"additionalProperties":{"type":"string"},"description":"The localized description of the variation value.","format":"localized","type":"object"},"image":{"$ref":"#/definitions/media_file","description":"The first product image for the configured viewtype and this variation value."},"image_swatch":{"$ref":"#/definitions/media_file","description":"The first product image for the configured viewtype and this variation value. (typically the swatch image)"},"link":{"description":"","type":"string"},"name":{"additionalProperties":{"type":"string"},"description":"The localized display name of the variation value.","format":"localized","type":"object"},"orderable":{"description":"A flag indicating whether at least one variant with this variation attribute value is available to sell.","type":"boolean"},"position":{"description":"The position of the value among all values of a variation attribute.","format":"double","type":"number"},"value":{"description":"The actual variation value.","minLength":1,"type":"string"}},"required":["value"]},"variation_attribute_values":{"description":"Document representing an unfiltered list of variation attribute values.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/variation_attribute_value"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"variation_attributes":{"description":"Document representing an unfiltered list of variation attributes.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/variation_attribute"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"variation_group":{"description":"Document representing a variation group.","properties":{"link":{"description":"The URL addressing the product.","type":"string"},"orderable":{"description":"A flag indicating whether the variation group is orderable.","type":"boolean"},"price":{"description":"The sales price of the variation group.","format":"double","type":"number"},"price_per_unit":{"description":"The sales price per unit of the variation group.","format":"double","type":"number"},"product_id":{"description":"The id (SKU) of the variation group.","maxLength":100,"minLength":1,"type":"string"},"variation_values":{"additionalProperties":{"type":"string"},"description":"The actual variation attribute id - value pairs.","type":"object"}}},"variation_groups":{"description":"Document representing an unfiltered list of variation groups.","properties":{"count":{"description":"The number of returned documents.","format":"int32","type":"integer"},"data":{"description":"","items":{"$ref":"#/definitions/variation_group"},"type":"array"},"expand":{"description":"The list of expands set for the search request. Expands are optional.","items":{"type":"string"},"type":"array"},"next":{"description":"The URL of the next result page.","type":"string"},"previous":{"description":"The URL of the previous result page.","type":"string"},"select":{"description":"The fields that you want to select.","type":"string"},"start":{"description":"The zero-based index of the first search hit to include in the result.","format":"int32","minimum":0,"type":"integer"},"total":{"description":"The total number of documents.","format":"int32","type":"integer"}}},"version_range_object":{"description":"Object to represent the Version Range. Used in resources_object.","properties":{"from":{"description":"Starting version","type":"string"},"until":{"description":"Ending version","type":"string"}}},"webdav_permission":{"description":"Document representing a WebDAV permission.","properties":{"description":{"additionalProperties":{"type":"string"},"description":"The description of the WebDAV permission.","format":"localized","type":"object"},"folder":{"description":"The folder of the WebDAV permission.","type":"string"},"type":{"description":"The permission type.","type":"string"},"values":{"description":"The list of possible values for the WebDAV permission, e.g. ACCESS or READONLY.","items":{"type":"string"},"type":"array"}}},"webdav_permissions":{"description":"Document representing the available WebDAV permissions.","properties":{"scopes":{"description":"The available WebDAV permission scopes (e.g. unscoped).","items":{"type":"string"},"type":"array"},"unscoped":{"description":"The collection of available unscoped WebDAV permissions.","items":{"$ref":"#/definitions/webdav_permission"},"type":"array"}}}},"x-documents":"https://demo-ocapi.demandware.net/s/-/dw/meta/v1/rest/data/20.8/documents?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","host":"demo-ocapi.demandware.net","info":{"title":"Data API","version":"20.8"},"paths":{"/alerts/descriptors":{"get":{"description":"Gets a collection of all alert descriptors","operationId":"getAlertsDescriptors","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/alert_descriptors"}}},"security":[{"oauth2_application":[]}],"tags":["alerts"]}},"/alerts/descriptors/{application_id}":{"get":{"description":"Gets a collection of all alert descriptors for the given application context.","operationId":"getAlertsDescriptorsByID","parameters":[{"description":"The application ID.","in":"path","minLength":1,"name":"application_id","required":true,"type":"string"},{"in":"query","name":"application_context_path","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/alert_descriptors"}}},"security":[{"oauth2_application":[]}],"tags":["alerts"]}},"/alerts/descriptors/{application_id}/{application_context_path}/{message_id}":{"get":{"description":"Gets a single alert descriptor","operationId":"getAlertsDescriptorsByIDByIDByID","parameters":[{"description":"The application ID.","in":"path","minLength":1,"name":"application_id","required":true,"type":"string"},{"description":"The application context path.","in":"path","minLength":1,"name":"application_context_path","required":true,"type":"string"},{"description":"The message ID.","in":"path","minLength":1,"name":"message_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/alert_descriptor"}},"404":{"description":"If no alert descriptor was found for the given path."}},"security":[{"oauth2_application":[]}],"tags":["alerts"]}},"/alerts/descriptors/{application_id}/{application_context_path}/{message_id}/revalidate":{"patch":{"description":"Triggers rule validation for all described descriptors. When a validation rule for a descriptor is triggered active alerts might be deleted if the conditions are not met anymore.    Additionally, new alerts might be created if conditions of a descriptor are now met. If the alert descriptor is context-specific, a context object ID needs to be provided in the request body.    The request body can be ued to further restrict the set of descriptors that are validated.","operationId":"patchAlertsDescriptorsByIDByIDByIDRevalidate","parameters":[{"description":"The application ID.","in":"path","minLength":1,"name":"application_id","required":true,"type":"string"},{"description":"The application context path.","in":"path","minLength":1,"name":"application_context_path","required":true,"type":"string"},{"description":"The message ID.","in":"path","minLength":1,"name":"message_id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/alert_descriptors_revalidation_request"}}],"responses":{"400":{"description":"If the descriptor is context specific but no context object id was provided in the request body."},"204":{"description":""},"404":{"description":"If no matching alert descriptor was found."}},"security":[{"oauth2_application":[]}],"tags":["alerts"]}},"/alerts/items":{"get":{"description":"Gets a collection of all alerts","operationId":"getAlertsItems","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/alert_items"}}},"security":[{"oauth2_application":[]}],"tags":["alerts"]}},"/alerts/items/{application_id}":{"get":{"description":"Gets a collection of alerts for the given application context","operationId":"getAlertsItemsByID","parameters":[{"description":"The application ID.","in":"path","minLength":1,"name":"application_id","required":true,"type":"string"},{"in":"query","name":"application_context_path","type":"string"},{"in":"query","name":"context_object_id","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/alert_items"}}},"security":[{"oauth2_application":[]}],"tags":["alerts"]}},"/alerts/items/{application_id}/{application_context_path}/{message_id}/{context_object_id}":{"delete":{"description":"Deletes a single alert If the alert depends on a context object, the last path elemnt denotes the context object id.    If the alert is independent from a context, use - as the last path element","operationId":"deleteAlertsItemsByIDByIDByIDByID","parameters":[{"description":"The application ID.","in":"path","minLength":1,"name":"application_id","required":true,"type":"string"},{"description":"The application context path.","in":"path","minLength":1,"name":"application_context_path","required":true,"type":"string"},{"description":"The message ID.","in":"path","minLength":1,"name":"message_id","required":true,"type":"string"},{"description":"The context object ID. Use '-' for alerts that don't have a context object.","in":"path","minLength":1,"name":"context_object_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"If no alert was found for the given path."}},"security":[{"oauth2_application":[]}],"tags":["alerts"]},"get":{"description":"Gets a single alert If the alert depends on a context object, the last path elemnt denotes the context object id.    If the alert is independent from a context, use - as the last path element","operationId":"getAlertsItemsByIDByIDByIDByID","parameters":[{"description":"The application ID.","in":"path","minLength":1,"name":"application_id","required":true,"type":"string"},{"description":"The application context path.","in":"path","minLength":1,"name":"application_context_path","required":true,"type":"string"},{"description":"The message ID.","in":"path","minLength":1,"name":"message_id","required":true,"type":"string"},{"description":"The context object ID. Use '-' for alerts that don't have a context object.","in":"path","minLength":1,"name":"context_object_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/alert_item"}}},"security":[{"oauth2_application":[]}],"tags":["alerts"]}},"/alerts/usersettings":{"get":{"description":"Gets the alert settings for the user.","operationId":"getAlertsUsersettings","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/alert_settings"}}},"security":[{"oauth2_application":[]}],"tags":["alerts"]},"patch":{"description":"Changes the alert settings for the user.","operationId":"patchAlertsUsersettings","parameters":[{"in":"body","name":"body","schema":{"$ref":"#/definitions/alert_settings"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/alert_settings"}}},"security":[{"oauth2_application":[]}],"tags":["alerts"]}},"/catalog_search":{"post":{"description":"Searches for catalogs.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n name - String\n description - String\n creation_date - DateTime\n \n \n There are two additional fields that can be used as search filters. They are not attributes in CatalogWO object, \n but can be used as filters to query catalogs based on site assignments.\n \n is_master_catalog - Boolean\n is_storefront_catalog - Boolean\n \n \n On using is_master_catalog in the search query, catalogs without any site assignments are returned. \n On using is_storefront_catalog in the search query, catalogs with one or more site assignments are returned.\n \n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n name - String\n description - String\n creation_date - DateTime\n ","operationId":"postCatalogSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/catalog_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["catalog_search"]}},"/catalogs":{"get":{"description":"Action to get all the catalogs with no filtering.","operationId":"getCatalogs","parameters":[{"description":"Optional start index for retrieving the items from a given index (default 0).","format":"int32","in":"query","name":"start","type":"integer"},{"description":"Optional count for retrieving only a subset of the items (default is 25).","format":"int32","in":"query","name":"count","type":"integer"},{"description":"The property selector.","in":"query","name":"select","type":"string"},{"description":"","in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/catalogs"}}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}":{"get":{"description":"Gets catalog information by catalog Id.\n \n Expansion \"stats\" can be used to retrieved some expensive statistic data, such as assigned_product_count and owned_product_count.\n Example: /s/-/dw/data/v99_9/catalogs/my-catalog?expand=stats","operationId":"getCatalogsByID","parameters":[{"description":"The id of the requested catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/catalog"}},"404":{"description":"Thrown in case the catalog does not exist matching the given id or the catalog identified was already in deletion."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"patch":{"description":"Updates the catalog with the specified information.","operationId":"patchCatalogsByID","parameters":[{"description":"The id of the requested catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/catalog"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/catalog"}},"404":{"description":"Thrown in case the catalog id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/categories":{"get":{"description":"Action to get all the categories with no filtering.","operationId":"getCatalogsByIDCategories","parameters":[{"description":"","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/categories"}},"404":{"description":"Indicates that the catalog is not provided in the request."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/categories/{category_id}":{"delete":{"description":"Deletes the category by catalog ID and category ID","operationId":"deleteCatalogsByIDCategoriesByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The category id to remove","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that the catalog is not provided in the request. or Indicates that the category does not exist for the catalog provided in \n              the request."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"get":{"description":"Action to read an existing category within a catalog. By default, the server\n also returns the first level of sub-categories, but you can specify another level by setting the levels\n parameter. Please note, using a large value for levels may cause performance \n issues in case of a large and deep category tree.","operationId":"getCatalogsByIDCategoriesByID","parameters":[{"description":"the id of the catalog that the category belongs to","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"the id of the category requested","in":"path","maxLength":256,"minLength":1,"name":"category_id","required":true,"type":"string"},{"format":"int32","in":"query","minimum":0,"name":"levels","type":"integer"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category"}},"404":{"description":"Indicates that the catalog is not provided in the request. or Indicates that the category does not exist for the catalog provided in \n              the request."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"patch":{"description":"Updates a catalog category using the information provided.","operationId":"patchCatalogsByIDCategoriesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the category","in":"path","maxLength":256,"minLength":1,"name":"category_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/category"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category"}},"400":{"description":"Indicates that the category in the request is not valid \n \t\t\t\t(the argument indicates the field that was invalid)."},"404":{"description":"Indicates that the catalog is not provided in the request. or Indicates that the category does not exist for the catalog provided in \n              the request."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"put":{"description":"Creates a catalog category using the information provided.","operationId":"putCatalogsByIDCategoriesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the category to be created","in":"path","maxLength":256,"minLength":1,"name":"category_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/category"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category"}},"400":{"description":"Indicates that the category in the request is not valid \n \t\t\t\t(the argument indicates the field that was invalid). or Indicates that the category ID in the request URL does not match the category ID in the request body."},"404":{"description":"Indicates that the catalog is not provided in the request."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/categories/{category_id}/category_links":{"get":{"description":"Action to get a set of outgoing category links in a given catalog category, sorted by position.","operationId":"getCatalogsByIDCategoriesByIDCategoryLinks","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the source category.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_links"}},"404":{"description":"Thrown in case the source catalog does not exist or Thrown in case the source category does not exist"}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/categories/{category_id}/category_links/{target_catalog_id}/{target_category_id}/{type}":{"delete":{"description":"Deletes the category link by ID","operationId":"deleteCatalogsByIDCategoriesByIDCategoryLinksByIDByIDByID","parameters":[{"description":"The id of the source catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the source category.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"description":"The id of the target catalog.","in":"path","minLength":1,"name":"target_catalog_id","required":true,"type":"string"},{"description":"The id of the target category.","in":"path","minLength":1,"name":"target_category_id","required":true,"type":"string"},{"description":"the link type","in":"path","name":"type","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Thrown in case the source catalog or the target catalog do not exist or Thrown in case the source category or the target category do not exist or Thrown in case the category link does not exist from the source catalog/category to the destination catalog/category with the given type."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"get":{"description":"Action to get category link information.","operationId":"getCatalogsByIDCategoriesByIDCategoryLinksByIDByIDByID","parameters":[{"description":"The id of the source catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the source category.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"description":"The id of the target catalog.","in":"path","minLength":1,"name":"target_catalog_id","required":true,"type":"string"},{"description":"The id of the target category.","in":"path","minLength":1,"name":"target_category_id","required":true,"type":"string"},{"description":"the link type","in":"path","name":"type","required":true,"type":"string"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_link"}},"404":{"description":"Thrown in case the source catalog or the target catalog do not exist or Thrown in case the source category or the target category do not exist or Thrown in case the category link does not exist from the source catalog/category to the destination catalog/category with the given type."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"patch":{"description":"Updates the category link with the specified information.","operationId":"patchCatalogsByIDCategoriesByIDCategoryLinksByIDByIDByID","parameters":[{"description":"The id of the source catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the source category.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"description":"The id of the target catalog.","in":"path","minLength":1,"name":"target_catalog_id","required":true,"type":"string"},{"description":"The id of the target category.","in":"path","minLength":1,"name":"target_category_id","required":true,"type":"string"},{"description":"the link type","in":"path","name":"type","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/category_link"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_link"}},"404":{"description":"Thrown in case the source catalog or the target catalog do not exist or Thrown in case the source category or the target category do not exist or Thrown in case the category link does not exist from the source catalog/category to the destination catalog/category with the given type."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"put":{"description":"Creates a category link using the information provided. If a category link with the same unique identifier,\n it will be updated with the new position.","operationId":"putCatalogsByIDCategoriesByIDCategoryLinksByIDByIDByID","parameters":[{"description":"The id of the source catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the source category.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"description":"The id of the target catalog.","in":"path","minLength":1,"name":"target_catalog_id","required":true,"type":"string"},{"description":"The id of the target category.","in":"path","minLength":1,"name":"target_category_id","required":true,"type":"string"},{"description":"the link type","in":"path","name":"type","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/category_link"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_link"}},"404":{"description":"Thrown in case the source catalog or the target catalog do not exist or Thrown in case the source category or the target category do not exist"}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/categories/{category_id}/category_product_assignment_search":{"post":{"description":"Searches for category product assignments.\n \n The query attribute specifies a complex query that can be used to narrow down the search. This is the list\n of searchable attributes:\n \n product_id - String\n product_name - String\n online_flag - Boolean \n searchable - Boolean \n valid_from - DateTime \n valid_to - DateTime \n creation_date - DateTime\n \n \n Sortable Fields:\n \n product_id - String\n product_name - String\n position - Double\n creation_date - DateTime\n \n \n Expansions that can be applied for the search request:\n \n product_base - String - This expand will enable retrieval of the following basic Product information: \n product_images - String - to fetch preview image and image groups specified for the given product\n product_all_images - String - to fetch preview image and image groups specified for the product plus images for its variants and variation groups\n product_variations - String to fetch variations related information, version 17.8+\n product_availability - String to fetch availability related information, version 17.8+\n product_categories - String to fetch category related information, version 17.8+\n product_prices - String to fetch prices related information, version 17.8+\n product_options - String to fetch options related information, version 17.8+\n product_all - String to fetch all expanded information, version 17.8+\n\n \t\n \t\tbrand\n    \tean\n      link\n  \tlong_description\n      manufacturer_name\n      manufacturer_sku\n \t\tname\n      page_description\n      page_keywords\n      page_title\n      searchable\n   \tshort_description\n      type\n      unit\n     \tupc\n \t\n ","operationId":"postCatalogsByIDCategoriesByIDCategoryProductAssignmentSearch","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the category.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/category_product_assignment_search_request"}},{"in":"query","name":"site_id","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_product_assignment_search_result"}},"400":{"description":"Thrown if the query is ill-formed."},"404":{"description":"Thrown if the category does not exist matching the given catalog_id. or Thrown if the catalog does not exist matching the given category_id."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/categories/{category_id}/products/{product_id}":{"delete":{"description":"Removes a category product assignment;\n \n \n For example, if we have products A, B, C at positions 1, 2, 7.5 and delete assignment for product B, \n this will end up the products A, B, C at positions 1, null, 7.5.","operationId":"deleteCatalogsByIDCategoriesByIDProductsByID","parameters":[{"description":"The catalog of the assignment.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the requested category.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"description":"The id of the requested product to un-assign.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Thrown if the category does not exist matching the given id. or Thrown if the catalog does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"get":{"description":"Retrieves category product assignment information.\n \n Expands that can be applied for the get request\n \n product_base - String\n product_images - String - to fetch image groups specified for the given product\n product_all_images - String - to fetch image groups specified for the given product plus images for its variants and variation groups\n ","operationId":"getCatalogsByIDCategoriesByIDProductsByID","parameters":[{"description":"The catalog of the assignment.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the requested category.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"description":"The id (SKU) of the requested assigned product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_product_assignment"}},"404":{"description":"Thrown if the category does not exist matching the given id. or Thrown if the catalog does not exist matching the given id. or Thrown if the product does not exist matching the given id. or Thrown if the category product assignment does not exist matching the given ids."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"patch":{"description":"Updates the category product assignment with the specified information, such as position. \n  As the assigned position n is a normalized target position, we'll make sure that the product is assigned\n to a position so that the order of positions are maintained. \n\n For example, if we have products A, B, C, D at positions 1, 2, 3, 4 and update product A with new position 3, \n the end result is B, C, A, D with order of positions 1, 2, 3, 4. If we then update product C to no position,\n the end result is B, A, D, C with order of positions 1, 2, 3, null.\n\n If there are n existing positioned assignment, updating product to position >= n will end with new assignment with position such that the order of positions is maintained.","operationId":"patchCatalogsByIDCategoriesByIDProductsByID","parameters":[{"description":"The id of the requested catalog to which the product is assigned.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the requested category to which the product is assigned.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"description":"The id (SKU) of the requested assigned product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/category_product_assignment"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_product_assignment"}},"404":{"description":"Thrown if the category does not exist matching the given id. or Thrown if the catalog does not exist matching the given id. or Thrown if the product does not exist matching the given id. or Thrown if the category product assignment does not exist."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"put":{"description":"Creates a category product assignment using the information provided; \n \n As the assigned position n is a normalized target position, we'll make sure that the product is assigned\n to a position so that the order of positions are maintained. \n \n For example, product A, B, C at position 1, 2, 3. product D is assigned to\n position 2, the end result is A, D, B, C with order of positions 1, 2, 3, 4;\n \n If there are n existing positioned assignment, assigning a new product to position >= n+1 will end\n with new assignment with position n+1.","operationId":"putCatalogsByIDCategoriesByIDProductsByID","parameters":[{"description":"The id of the requested catalog to which to assign the product.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the requested category to which to assign the product.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"description":"The id (SKU) of the requested product to assign.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/category_product_assignment"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_product_assignment"}},"400":{"description":"if the Id in request is not the same as the ID in document."},"404":{"description":"Thrown if the category does not exist matching the given id. or Thrown if the catalog does not exist matching the given id. or Thrown if the product does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/category_search":{"post":{"description":"Searches for catalog categories in the scope of catalog\n By default, the server also returns the first level of subcategories,\n  but you can specify another level by setting the levels parameter. \n  Please note, using a large value for levels may cause performance \n  issues in case of a large and deep category tree.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n name - String\n description - String\n creation_date - DateTime\n online - Boolean\n parent_category_id - String\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n name - String\n description - String\n creation_date - DateTime\n online - Boolean \n position - Double \n ","operationId":"postCatalogsByIDCategorySearch","parameters":[{"description":"The id of the catalog.","in":"path","maxLength":256,"minLength":1,"name":"catalog_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}},{"format":"int32","in":"query","minimum":0,"name":"levels","type":"integer"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_search_result"}},"400":{"description":"Thrown if the query is ill-formed."},"404":{"description":"Thrown if the specified catalog does not exist."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/shared_product_options":{"get":{"description":"Read shared product options in a catalog.","operationId":"getCatalogsByIDSharedProductOptions","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","name":"currency","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_options"}},"404":{"description":"Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/shared_product_options/{id}":{"delete":{"description":"Deletes a shared product option by ID.","operationId":"deleteCatalogsByIDSharedProductOptionsByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the shared product option is not found. or Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"get":{"description":"Read a shared product option in a catalog.","operationId":"getCatalogsByIDSharedProductOptionsByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"currency","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option"}},"404":{"description":"Indicates the shared product option is not found. or Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"patch":{"description":"Updates a shared product option with the information provided.","operationId":"patchCatalogsByIDSharedProductOptionsByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_option"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option"}},"404":{"description":"Indicates the catalog is not found. or Indicates the shared product option is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"put":{"description":"Creates a shared product option using the information provided.","operationId":"putCatalogsByIDSharedProductOptionsByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_option"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option"}},"400":{"description":"Indicates the shared product option is a duplicate."},"404":{"description":"Indicates the id specified is not a valid attribute definition. or Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/shared_product_options/{option_id}/values":{"get":{"description":"Read shared product option values of a shared product option in a catalog.","operationId":"getCatalogsByIDSharedProductOptionsByIDValues","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option_values"}},"404":{"description":"Indicates the catalog is not found. or Indicates the shared product option is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/shared_product_options/{option_id}/values/{id}":{"delete":{"description":"Deletes a shared product option value by ID.","operationId":"deleteCatalogsByIDSharedProductOptionsByIDValuesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"description":"The id of the shared product option value.","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the catalog is not found. or Indicates the shared product option is not found. or Indicates the shared product option value is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"get":{"description":"Read a shared product option value of a shared product option in a catalog.","operationId":"getCatalogsByIDSharedProductOptionsByIDValuesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"description":"the id of shared product option value.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option_value"}},"404":{"description":"Indicates the catalog is not found. or Indicates the shared product option is not found. or Indicates the shared product option value is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"patch":{"description":"Updates a shared product option value with the information provided.","operationId":"patchCatalogsByIDSharedProductOptionsByIDValuesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"description":"The id of the shared product option value.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_option_value"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option_value"}},"404":{"description":"Indicates the catalog is not found. or Indicates the shared product option is not found. or Indicates the shared product option value is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"put":{"description":"Creates a shared product option value using the information provided.","operationId":"putCatalogsByIDSharedProductOptionsByIDValuesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the shared product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"description":"The id of the shared product option value.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_option_value"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option_value"}},"404":{"description":"Indicates the catalog is not found. or Indicates the shared product option is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/shared_variation_attributes":{"get":{"description":"Reads variation attributes of a Domain.","operationId":"getCatalogsByIDSharedVariationAttributes","parameters":[{"description":"id of the catalog","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attributes"}},"404":{"description":"Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/shared_variation_attributes/{attribute_id}/values":{"get":{"description":"Reads variation attribute values of a variation attribute of a catalog.","operationId":"getCatalogsByIDSharedVariationAttributesByIDValues","parameters":[{"description":"id of the owning catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The variation attribute ID that contains the values.","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute_values"}},"404":{"description":"Indicates the catalog is not found. or Indicate the variation attribute is not found"}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/shared_variation_attributes/{attribute_id}/values/{id}":{"delete":{"description":"Deletes the variation attribute value of a variation attribute bound to a catalog","operationId":"deleteCatalogsByIDSharedVariationAttributesByIDValuesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the variation attribute that contains the value.","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"description":"The id of one value to remove","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"if the catalog id specified cannot be found or if the attribute id specified is not a valid variation attribute or if the value id specified does not a valid value id"}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"get":{"description":"Action to get Shared Variation Attribute value information.","operationId":"getCatalogsByIDSharedVariationAttributesByIDValuesByID","parameters":[{"description":"The owning catalog ID.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The variation attribute custom ID","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"description":"The id of the variation attribute value","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute_value"}},"404":{"description":"Indicates the catalog is not found. or Indicate the variation attribute is not found or Indicate the variation attribute value is not found"}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"patch":{"description":"Updates the variation attribute value of a variation attribute of a catalog.","operationId":"patchCatalogsByIDSharedVariationAttributesByIDValuesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the requested variation attribute.","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"description":"The id of the variation value.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_attribute_value"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute_value"}},"404":{"description":"if the catalog id specified cannot be found or if the attribute id specified is not a valid variation attribute or if the value id specified does not a valid value id"}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"put":{"description":"Action to create a Shared Variation Attribute value.","operationId":"putCatalogsByIDSharedVariationAttributesByIDValuesByID","parameters":[{"description":"The owning catalog ID.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The variation attribute ID","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"description":"The id of the variation attribute value","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_attribute_value"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute_value"}},"404":{"description":"Indicates the catalog is not found. or Indicate the variation attribute is not found or Indicate the variation attribute value is not found"}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/catalogs/{catalog_id}/shared_variation_attributes/{id}":{"delete":{"description":"Deletes the variation attribute by ID","operationId":"deleteCatalogsByIDSharedVariationAttributesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"One variation attribute id to remove","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Thrown in case the variation attribute does not exist matching item or Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"get":{"description":"Action to get shared variation attribute information only for master Catalog.","operationId":"getCatalogsByIDSharedVariationAttributesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the requested variation attribute.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute"}},"404":{"description":"Thrown in case the variation attribute does not exist matching the given id or Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"patch":{"description":"Updates the variation attribute with the specified information.\n\n \n name\n slicing\n ","operationId":"patchCatalogsByIDSharedVariationAttributesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the requested variation attribute.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_attribute"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute"}},"404":{"description":"if the catalog id specified cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]},"put":{"description":"Creates a variation attribute using the information provided.","operationId":"putCatalogsByIDSharedVariationAttributesByID","parameters":[{"description":"The id of the catalog.","in":"path","minLength":1,"name":"catalog_id","required":true,"type":"string"},{"description":"The id of the variation attribute to create.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_attribute"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute"}},"400":{"description":""},"404":{"description":"if attribute definition supplied is not a product attribute or Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["catalogs"]}},"/category_search":{"post":{"description":"Searches for catalog categories anywhere they appear.\n By default, the server also returns the first level of subcategories,\n  but you can specify another level by setting the levels parameter. \n  Please note, using a large value for levels may cause performance \n  issues in case of a large and deep category tree.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n name - String\n description - String\n creation_date - DateTime\n online - Boolean\n catalog_id - String\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n name - String\n description - String\n creation_date - DateTime\n online - Boolean \n position - Double \n ","operationId":"postCategorySearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}},{"description":"","format":"int32","in":"query","minimum":0,"name":"levels","type":"integer"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/category_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["category_search"]}},"/code_versions":{"get":{"description":"Read all existing code versions.","operationId":"getCodeVersions","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/code_version_result"}}},"security":[{"oauth2_application":[]}],"tags":["code_versions"]}},"/code_versions/{code_version_id}":{"delete":{"description":"Delete a code version.","operationId":"deleteCodeVersionsByID","parameters":[{"description":"The id of the code version.","in":"path","minLength":1,"name":"code_version_id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates that a code version with the given id can't be \n         deleted (because it is active)."},"204":{"description":""},"404":{"description":"Indicates that a code version with the given id was not found."}},"security":[{"oauth2_application":[]}],"tags":["code_versions"]},"get":{"description":"Read a code version.","operationId":"getCodeVersionsByID","parameters":[{"description":"The id of the code version.","in":"path","minLength":1,"name":"code_version_id","required":true,"type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/code_version"}},"404":{"description":"Indicates that a code version with the given id was not found."}},"security":[{"oauth2_application":[]}],"tags":["code_versions"]},"patch":{"description":"Update an existing code version.\n \n  Only an inactive code version can be updated.\n  Only the active flag and the id can be changed. The active flag can therefore only set to \"true\". \n  To set the active flag to \"false\" will not work.\n ","operationId":"patchCodeVersionsByID","parameters":[{"description":"The id of the code version.","in":"path","minLength":1,"name":"code_version_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/code_version"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/code_version"}},"400":{"description":"Indicates that a code version with the given id can't be updated (because it is active)."},"404":{"description":"Indicates that a code version with the given id was not found."},"409":{"description":"Indicates that a code version with the given id already exists."}},"security":[{"oauth2_application":[]}],"tags":["code_versions"]},"put":{"description":"Create a new code version.","operationId":"putCodeVersionsByID","parameters":[{"description":"The id of the code version.","in":"path","minLength":1,"name":"code_version_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/code_version"}},"409":{"description":"Indicates that a code version with the given id already exists."}},"security":[{"oauth2_application":[]}],"tags":["code_versions"]}},"/custom_object_definitions/{object_type}/attribute_definition_search":{"post":{"description":"Searches the attribute definitions of the specified custom object type.\n The query attribute specifies a complex query that can be used to narrow down the search. Attributes are grouped\n into different buckets.  These are the list of searchable attributes with their corresponding buckets:\n\n Main:\n \n    id - String\n    display_name* - Localized String\n    description* - Localized String\n    key - boolean\n    mandatory - boolean\n    searchable - boolean\n    system - boolean\n    visible - boolean\n \n Definition version:\n \n    localizable - boolean\n    site_specific - boolean\n    value_type - one of {string, int, double, text, html, date, image, boolean, money, quantity, datetime, email, password, set_of_string, set_of_int, set_of_double, enum_of_string, enum_of_int, unknown}\n \n\n Only attributes in the same bucket can be joined using a disjunction (OR).\n For instance, when joining localizable and description above, only a conjunction is allowed (AND), whereas display_name\n and description can be joined using a disjunction because they are in the same bucket.  If an attribute\n is used in a disjunction (OR) that violates this rule, an exception will be thrown.\n\n  Additionally, attribute definitions can also be searched by attribute group.\n group - String\n \n\n These attributes are not searchable or sortable for built in system attributes.  They work normally for non\n system attributes.\n\n Note that only searchable attributes can be used in sorting.","operationId":"postCustomObjectDefinitionsByIDAttributeDefinitionSearch","parameters":[{"description":"The type of object","in":"path","name":"object_type","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definition_search_result"}},"400":{"description":"Indicates the query is ill-formed."},"404":{"description":"Indicates that the object type cannot be found."}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]}},"/custom_object_definitions/{object_type}/attribute_definitions":{"get":{"description":"Action to get all the attribute definitions with no filtering.","operationId":"getCustomObjectDefinitionsByIDAttributeDefinitions","parameters":[{"description":"","in":"path","name":"object_type","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definitions"}},"404":{"description":"Thrown in case the object type cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]}},"/custom_object_definitions/{object_type}/attribute_definitions/{id}":{"delete":{"description":"Deletes the attribute definition by ID","operationId":"deleteCustomObjectDefinitionsByIDAttributeDefinitionsByID","parameters":[{"description":"The metadata object that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"description":"Attribute definition id to remove","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"400":{"description":"Thrown when trying to delete a internal attribute of custom object or Thrown when trying to delete a key attribute of custom object"},"204":{"description":""},"404":{"description":"Thrown in case the object type cannot be found or Thrown in case the attribute definition does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]},"get":{"description":"Action to get attribute definition information.","operationId":"getCustomObjectDefinitionsByIDAttributeDefinitionsByID","parameters":[{"description":"The object type id that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the requested attribute definition.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definition"}},"404":{"description":"Thrown in case the object type cannot be found or Thrown in case the attribute definition does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]},"patch":{"description":"Updates the attribute definition with the specified information.","operationId":"patchCustomObjectDefinitionsByIDAttributeDefinitionsByID","parameters":[{"description":"The object type id that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the requested attribute definition.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"header","name":"If-Match","type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/object_attribute_definition"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definition"}},"400":{"description":"Thrown when trying to modify a key attribute of custom object"},"404":{"description":"Thrown in case the object type cannot be found or Thrown in case the attribute definition does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]},"put":{"description":"Creates a attribute definition using the information provided.","operationId":"putCustomObjectDefinitionsByIDAttributeDefinitionsByID","parameters":[{"description":"The metadata object that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the attribute definition to create.","in":"path","name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/object_attribute_definition"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definition"}},"400":{"description":"Thrown when trying to create a key attribute of a custom object or if the attribute definition could not be created. or if trying to create a localizable attribute with a non-localizable type or if the Id in request is not the same as the ID in document."},"404":{"description":"Thrown in case the object type cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]}},"/custom_object_definitions/{object_type}/attribute_group_search":{"post":{"description":"Searches for attribute groups.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n display_name - Localized <String>\n description - Localized <String>\n position - Double\n internal - Boolean\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n display_name - Localized <String>\n description - Localized <String>\n position - Double\n internal - Boolean\n ","operationId":"postCustomObjectDefinitionsByIDAttributeGroupSearch","parameters":[{"description":"","in":"path","name":"object_type","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_group_search_result"}},"400":{"description":"Thrown if the query is ill-formed."},"404":{"description":"Thrown in case the object type cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]}},"/custom_object_definitions/{object_type}/attribute_groups":{"get":{"description":"Action to get all the attribute groups with no filtering.","operationId":"getCustomObjectDefinitionsByIDAttributeGroups","parameters":[{"description":"","in":"path","name":"object_type","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_groups"}},"404":{"description":"Thrown in case the object type cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]}},"/custom_object_definitions/{object_type}/attribute_groups/{group_id}/attribute_definitions/{def_id}":{"delete":{"description":"Un-assign an attribute definition from an attribute group.","operationId":"deleteCustomObjectDefinitionsByIDAttributeGroupsByIDAttributeDefinitionsByID","parameters":[{"description":"The ID of the custom object that contains the attribute definition and attribute group.","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The ID of the attribute group.","in":"path","minLength":1,"name":"group_id","required":true,"type":"string"},{"description":"The ID of the attribute definition.","in":"path","minLength":1,"name":"def_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the specified custom object is not found. or Indicates the specified attribute group is not found. or Indicates the specified attribute definition is not found."}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]},"put":{"description":"Assign an attribute definition to an attribute group.","operationId":"putCustomObjectDefinitionsByIDAttributeGroupsByIDAttributeDefinitionsByID","parameters":[{"description":"The ID of the custom object that contains the attribute definition and attribute group.","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The ID of the attribute group.","in":"path","minLength":1,"name":"group_id","required":true,"type":"string"},{"description":"The ID of the attribute definition.","in":"path","minLength":1,"name":"def_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the specified custom object is not found. or Indicates the specified attribute group is not found. or Indicates the specified attribute definition is not found."}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]}},"/custom_object_definitions/{object_type}/attribute_groups/{id}":{"delete":{"description":"Deletes the attribute group by ID","operationId":"deleteCustomObjectDefinitionsByIDAttributeGroupsByID","parameters":[{"description":"the object type id that contains this attribute gorup","in":"path","name":"object_type","required":true,"type":"string"},{"description":"One attribute group id to remove","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Thrown in case the object type cannot be found or Thrown in case the attribute group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]},"get":{"description":"Action to get attribute group information.","operationId":"getCustomObjectDefinitionsByIDAttributeGroupsByID","parameters":[{"description":"the object type id that contains this attribute gorup","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the requested attribute group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_group"}},"404":{"description":"Thrown in case the object type cannot be found or Thrown in case the attribute group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]},"patch":{"description":"Updates the attribute group with the specified information.","operationId":"patchCustomObjectDefinitionsByIDAttributeGroupsByID","parameters":[{"description":"the object type id that contains this attribute gorup","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the requested attribute group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"header","name":"If-Match","type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/object_attribute_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_group"}},"404":{"description":"Thrown in case the object type cannot be found or Thrown in case the attribute group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]},"put":{"description":"Creates a attribute group using the information provided.","operationId":"putCustomObjectDefinitionsByIDAttributeGroupsByID","parameters":[{"description":"the object type id that contains this attribute gorup","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the attribute group to create.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/object_attribute_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_group"}},"400":{"description":"when the id in the body does not match that provided in the URL"},"404":{"description":"Thrown in case the object type cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["custom_object_definitions"]}},"/custom_objects/{object_type}/{key}":{"delete":{"description":"Deletes a global Custom Object. If the Custom Object does not exist, this will do nothing. Note that the customization scripts are only called, if the Custom Object does exist.","operationId":"deleteCustomObjectsByIDByID","parameters":[{"description":"the ID of the object type","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"description":"the key attribute value of the Custom Object","in":"path","minLength":1,"name":"key","required":true,"type":"string"}],"responses":{"400":{"description":"If the object key must be an integer, but the path parameter has an invalid format"},"204":{"description":""},"404":{"description":"For an unknown object type ID"}},"security":[{"oauth2_application":[]}],"tags":["custom_objects"]},"get":{"description":"Reads a global Custom Object with a given object type ID and a value for the key attribute of the object which represents its unique identifier.","operationId":"getCustomObjectsByIDByID","parameters":[{"description":"the ID of the object type","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"description":"the key attribute value of the Custom Object","in":"path","minLength":1,"name":"key","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_object"}},"400":{"description":"If the object key must be an integer, but the path parameter has an invalid format"},"404":{"description":"For an unknown object key or For an unknown object type ID"}},"security":[{"oauth2_application":[]}],"tags":["custom_objects"]},"patch":{"description":"Updates a global Custom Object with information from request body. Note that only mentioned attributes will be updated and the key attribute is ignored. All other attributes will be left unattended.","operationId":"patchCustomObjectsByIDByID","parameters":[{"description":"the ID of the object type","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"description":"the key attribute value of the Custom Object","in":"path","minLength":1,"name":"key","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/custom_object"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_object"}},"400":{"description":"If the object key must be an integer, but the path parameter has an invalid format"},"404":{"description":"For an unknown object key or For an unknown object type ID"}},"security":[{"oauth2_application":[]}],"tags":["custom_objects"]},"put":{"description":"Creates a global Custom Object from request body. Note that an existing global Custom Object with the same key will be overwritten by this action.","operationId":"putCustomObjectsByIDByID","parameters":[{"description":"the ID of the object type","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"description":"the key attribute value of the Custom Object","in":"path","minLength":1,"name":"key","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/custom_object"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_object"}},"400":{"description":"If the object key must be an integer, but the path parameter has an invalid format"},"404":{"description":"For an unknown object key or For an unknown object type ID"}},"security":[{"oauth2_application":[]}],"tags":["custom_objects"]}},"/custom_objects_search/{object_type}":{"post":{"description":"Search resource for custom objects in scope of a specific custom object type.\n \n The custom object search document contains a search object that allows filtering on various attributes.\n \n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n key_value_string - String\n key_value_integer - Integer\n creation_date - Date\n last_modified - Date\n site_id - String\n any custom attribute\n \n \n Note that only searchable attributes can be used in sorting.","operationId":"postCustomObjectsSearchByID","parameters":[{"description":"ID of the object type to search objects for","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_object_search_result"}},"400":{"description":"Indicates that the value to search with does not match the\n              type of the search field."},"404":{"description":"In case of an unknown object type."}},"security":[{"oauth2_application":[]}],"tags":["custom_objects_search"]}},"/customer_lists/{customer_list_id}/customer_search":{"post":{"description":"Action to search for customers in a customer list.\n\n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n customer_no - String\n first_name - String\n second_name - String\n last_name - String\n suffix - String\n salutation - String\n title - String\n fax - String\n phone_home - String\n phone_business - String\n phone_mobile - String\n email - String\n gender - Integer\n company_name - String\n credentials.login - String\n credentials.enabled - boolean\n ","operationId":"postCustomerListsByIDCustomerSearch","parameters":[{"description":"The customer list id to search in","in":"path","maxLength":256,"minLength":1,"name":"customer_list_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_search_result"}}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]}},"/customer_lists/{list_id}":{"get":{"description":"Action to read an existing customerlist.","operationId":"getCustomerListsByID","parameters":[{"description":"the id of the customerlist","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_list"}},"404":{"description":"Indicates that there was no customerlist found for the customerlist id."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]}},"/customer_lists/{list_id}/customers":{"post":{"description":"Action to create a new customer. The customer is created using the specified credentials and customer\n information.This action verifies the following:\n \n Login acceptance criteria and uniqueness\n Mandatory customer properties\n \n If the action fails to create the customer, it returns a 400 fault with an appropriate message.","operationId":"postCustomerListsByIDCustomers","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/customer"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer"}},"400":{"description":"Indicates the login does not match the login acceptance criteria. or Indicates the login is already in use. or Indicates that the mandatory credentials are missing in the input document. or Indicates that the mandatory login property is missing in the input document."},"404":{"description":"Indicates that the customer list with the given customer list id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]}},"/customer_lists/{list_id}/customers/{customer_no}":{"delete":{"description":"Deletes the customer including all related information like the customer addresses.","operationId":"deleteCustomerListsByIDCustomersByID","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that the customer with the given customer number is unknown. or Indicates that the customer list with the given customer list id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]},"get":{"description":"Action to get customer information.","operationId":"getCustomerListsByIDCustomersByID","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer"}},"404":{"description":"Indicates that the customer with the given customer number is unknown. or Indicates that the customer list with the given customer list id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]},"patch":{"description":"Updates the customer with the specified information. The customer number is allowed to be updated but will result in a\n CustomerNumberAlreadyInUseException if there is already another customer with the same customer number existing.","operationId":"patchCustomerListsByIDCustomersByID","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/customer"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer"}},"400":{"description":"Indicates the login does not match the login acceptance criteria. or Indicates the login is already in use."},"404":{"description":"Indicates that the customer with the given customer number is unknown. or Indicates that the customer list with the given customer list id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]},"put":{"description":"Action to create a new customer. The customer is created using the specified customer number, credentials and\n customer information.This action verifies the following:\n \n Login acceptance criteria and uniqueness\n Mandatory customer properties\n \n If the action fails to create the customer, it returns a 400 fault with an appropriate message.","operationId":"putCustomerListsByIDCustomersByID","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/customer"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer"}},"400":{"description":"Indicates the login does not match the login acceptance criteria. or Indicates that the mandatory credentials are missing in the input document. or Indicates that the mandatory login property is missing in the input document. or Indicates that the given login is already in use."},"404":{"description":"Indicates that the customer list with the given customer list id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]}},"/customer_lists/{list_id}/customers/{customer_no}/addresses":{"get":{"description":"Action that returns a pageable list of all customer addresses. The\n default page size is 10 customer addresses.","operationId":"getCustomerListsByIDCustomersByIDAddresses","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"format":"int32","in":"query","minimum":0,"name":"start","type":"integer"},{"format":"int32","in":"query","maximum":200,"minimum":1,"name":"count","type":"integer"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_address_result"}},"404":{"description":"Indicates that the customer with the given customer number is unknown. or Indicates that the customer list with the given customer list id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]},"post":{"description":"The action creates a new customer address with the given address\n information.","operationId":"postCustomerListsByIDCustomersByIDAddresses","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/customer_address"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_address"}},"400":{"description":"If the address id is null or empty. or If the address id is already in use."},"404":{"description":"Indicates that the customer with the given customer number is unknown. or Indicates that the customer list with the given customer list id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]}},"/customer_lists/{list_id}/customers/{customer_no}/addresses/{address_id}":{"delete":{"description":"Action which deletes a customer address.","operationId":"deleteCustomerListsByIDCustomersByIDAddressesByID","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"description":"The address id","in":"path","minLength":1,"name":"address_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that the customer with the given customer number is unknown. or Indicates that the customer list with the given customer list id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]},"get":{"description":"Action which returns an address of a customer.","operationId":"getCustomerListsByIDCustomersByIDAddressesByID","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"description":"The address id","in":"path","minLength":1,"name":"address_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_address"}},"404":{"description":"Indicates that the customer with the given customer number is unknown. or Indicates that the customer list with the given customer list id is unknown. or Indicates that the customer address id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]},"patch":{"description":"Action which updates an address of a customer with the given address information.","operationId":"patchCustomerListsByIDCustomersByIDAddressesByID","parameters":[{"description":"The customer list id","in":"path","minLength":1,"name":"list_id","required":true,"type":"string"},{"description":"The customer number","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"description":"The address id","in":"path","minLength":1,"name":"address_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/customer_address"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_address"}},"400":{"description":"If the new address id is empty. or If the new address id is already in use."},"404":{"description":"Indicates that the customer with the given customer number is unknown. or Indicates that the customer list with the given customer list id is unknown. or Indicates that the customer address id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["customer_lists"]}},"/global_preferences/preference_groups/{group_id}/{instance_type}":{"get":{"description":"For the specified instance, read the custom preferences in the preference group at the global(organization) level.\n Specify 'current' to retrieve the preferences for the instance on which this call is being made. The system will recognize its type.","operationId":"getGlobalPreferencesPreferenceGroupsByIDByID","parameters":[{"description":"One of {staging,development,sandbox,production,current}.","in":"path","name":"instance_type","required":true,"type":"string"},{"description":"The ID of the preference group.","in":"path","name":"group_id","required":true,"type":"string"},{"in":"query","name":"mask_passwords","type":"boolean"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/organization_preferences"}},"404":{"description":"Indicates the preference group is not found."}},"security":[{"oauth2_application":[]}],"tags":["global_preferences"]},"patch":{"description":"For the specified instance, update one or more custom preferences in the preference group  at the global(organization) level.","operationId":"patchGlobalPreferencesPreferenceGroupsByIDByID","parameters":[{"description":"One of {staging,development,sandbox,production}.","in":"path","name":"instance_type","required":true,"type":"string"},{"description":"The ID of the preference group.","in":"path","name":"group_id","required":true,"type":"string"},{"in":"query","name":"mask_passwords","type":"boolean"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/organization_preferences"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/organization_preferences"}},"404":{"description":"Indicates the preference group is not found."}},"security":[{"oauth2_application":[]}],"tags":["global_preferences"]}},"/inventory_list_search":{"post":{"description":"Searches for inventory lists.\n \n The query attribute specifies a complex query that can be used to narrow down the search. This is the list\n of searchable attributes:\n \n id - String\n default_in_stock - boolean\n description - String\n on_order_inventory_enabled - boolean\n status - one of {\"normal\",\"delete\"}\n use_bundle_inventory_only - boolean\n ","operationId":"postInventoryListSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/inventory_list_search_result"}},"400":{"description":"Thrown if the query is ill-formed. or Thrown if the given selector is invalid."}},"security":[{"oauth2_application":[]}],"tags":["inventory_list_search"]}},"/inventory_lists":{"get":{"description":"Action to get all the inventory lists with no filtering.","operationId":"getInventoryLists","parameters":[{"description":"Optional start index for retrieving the items from a given index (default 0).","format":"int32","in":"query","name":"start","type":"integer"},{"description":"Optional count for retrieving only a subset of the items (default is 25).","format":"int32","in":"query","name":"count","type":"integer"},{"description":"The property selector.","in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/inventory_lists"}}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]}},"/inventory_lists/{id}":{"delete":{"description":"Deletes the inventory list by ID","operationId":"deleteInventoryListsByID","parameters":[{"description":"One inventory list id to remove","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]},"get":{"description":"Action to get inventory list information.","operationId":"getInventoryListsByID","parameters":[{"description":"The id of the requested inventory list.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/inventory_list"}},"404":{"description":"Thrown in case the inventory list does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]},"patch":{"description":"Updates the inventory list with the specified information.","operationId":"patchInventoryListsByID","parameters":[{"description":"The id of the requested inventory list.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/inventory_list"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/inventory_list"}},"404":{"description":"Thrown in case the inventory list does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]},"put":{"description":"Creates an inventory list using the information provided.","operationId":"putInventoryListsByID","parameters":[{"description":"The id of the inventory list to create.","in":"path","maxLength":256,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/inventory_list"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/inventory_list"}},"400":{"description":"if the Id in request is not the same as the ID in document."}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]}},"/inventory_lists/{inventory_list_id}/product_inventory_records":{"get":{"description":"Gets all product inventory records for an inventory list.","operationId":"getInventoryListsByIDProductInventoryRecords","parameters":[{"description":"The inventory list ID","in":"path","minLength":1,"name":"inventory_list_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_inventory_records"}},"404":{"description":"Indicates the inventory list does not exist."}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]}},"/inventory_lists/{inventory_list_id}/product_inventory_records/{product_id}":{"delete":{"description":"Deletes a product inventory record by ID.","operationId":"deleteInventoryListsByIDProductInventoryRecordsByID","parameters":[{"description":"The inventory list ID","in":"path","minLength":1,"name":"inventory_list_id","required":true,"type":"string"},{"description":"The product ID","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the product inventory record does not exist. or Indicates the inventory list does not exist."}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]},"get":{"description":"Gets a product inventory record.","operationId":"getInventoryListsByIDProductInventoryRecordsByID","parameters":[{"description":"The inventory list ID","in":"path","minLength":1,"name":"inventory_list_id","required":true,"type":"string"},{"description":"The product ID","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_inventory_record"}},"404":{"description":"Indicates the product inventory record does not exist. or Indicates the inventory list does not exist."}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]},"patch":{"description":"Updates the product inventory record with the specified information.","operationId":"patchInventoryListsByIDProductInventoryRecordsByID","parameters":[{"description":"The inventory list ID","in":"path","minLength":1,"name":"inventory_list_id","required":true,"type":"string"},{"description":"The product ID","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_inventory_record"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_inventory_record"}},"404":{"description":"Indicates the product inventory record does not exist. or Indicates the inventory list does not exist."}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]},"put":{"description":"Creates a product inventory record using the information provided.","operationId":"putInventoryListsByIDProductInventoryRecordsByID","parameters":[{"description":"The inventory list ID","in":"path","minLength":1,"name":"inventory_list_id","required":true,"type":"string"},{"description":"The product ID","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_inventory_record"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_inventory_record"}},"404":{"description":"Indicates the inventory list does not exist."}},"security":[{"oauth2_application":[]}],"tags":["inventory_lists"]}},"/job_execution_search":{"post":{"description":"Searches for job executions.\n \n The query attribute specifies a complex query that can be used to narrow down the search. This is the list of\n searchable attributes:\n \n id - String\n job_id - String\n start_time - Date\n end_time - Date\n status - String\n \n This is the list of sortable attributes:\n \n job_id - String\n start_time - Date\n end_time - Date\n status - String\n ","operationId":"postJobExecutionSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/job_execution_search_result"}}},"security":[{"oauth2_application":[]}],"tags":["job_execution_search"]}},"/jobs/{job_id}/executions":{"post":{"description":"Executes the job with the given job ID by creating and returning a job execution for it. The job might still be\n executed when the job execution is returned. Note that this resource is also intended for running system jobs.\n \n See Global Jobs for information on available system jobs.","operationId":"postJobsByIDExecutions","parameters":[{"description":"The ID of the job to execute.","in":"path","minLength":1,"name":"job_id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/job_execution_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/job_execution"}},"400":{"description":"if the job is\n             already running. or if the job is invalid\n             and is therefore not executable. or if the job could not\n             be restarted. or if the job\n             does not support restarting. or if the job could\n             not be executed."},"404":{"description":"if the job with the given job ID\n             doesn't exist."}},"security":[{"oauth2_application":[]}],"tags":["jobs"]}},"/jobs/{job_id}/executions/{id}":{"delete":{"description":"Deletes job execution information using the specified ID for the job having the specified job ID.","operationId":"deleteJobsByIDExecutionsByID","parameters":[{"description":"the ID of the job.","in":"path","minLength":1,"name":"job_id","required":true,"type":"string"},{"description":"the ID of the job execution","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"403":{"description":"if the\n             job execution is not finished."},"404":{"description":"for an\n             unknown job ID or job execution ID"}},"security":[{"oauth2_application":[]}],"tags":["jobs"]},"get":{"description":"Returns job execution information using the specified ID for the job having the specified job ID.","operationId":"getJobsByIDExecutionsByID","parameters":[{"description":"the ID of the job.","in":"path","minLength":1,"name":"job_id","required":true,"type":"string"},{"description":"the ID of the job execution","in":"path","name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/job_execution"}},"404":{"description":"for an\n             unknown job ID or job execution ID"}},"security":[{"oauth2_application":[]}],"tags":["jobs"]}},"/libraries/{library_id}/content/{content_id}":{"delete":{"description":"Deletes the content asset with the specified ID from the specified library. If the content asset is not found, the server returns a 404 (NotFoundException) fault. If the content asset is locked by another user, the server returns a 409 (ResourceLockedException) fault. If the connection is not secure, the server returns a 403 (SecureCommunicationRequiredException) fault.","operationId":"deleteLibrariesByIDContentByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"the ID of the content asset to remove.","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"}],"responses":{"412":{"description":"Indicates that the ID from the request body doesn't match the URL-Id."},"204":{"description":""},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the content asset with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"get":{"description":"Returns a content asset using the specified ID. If the content asset cannot be found, the server returns a 404 (ContentNotFoundException) fault. If the connection is not secure, the server returns a 403 (SecureCommunicationRequiredException).","operationId":"getLibrariesByIDContentByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"the ID of the content asset to retrieve.","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_asset"}},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the content asset with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"patch":{"description":"Updates a content asset. In the request, the If-Match header is required. The value of the header is an 'ETag' representing the last known base-point information for the content asset. If the header is missing, the server returns a 409 (IfMatchRequiredException) fault. If the header value does not match the server's 'ETag', the server returns a 412 (InvalidIfMatchException) fault. The delta information for the library folder containing the content asset is updated atomically: the information is written completely or not at all. If the content asset is locked, the server returns a 409 (ResourceLockedException) fault.","operationId":"patchLibrariesByIDContentByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"the ID of the content asset to retrieve.","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/content_asset"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_asset"}},"400":{"description":"Indicates that a content asset with the ID to change to is already existing."},"412":{"description":"Indicates that the ID from the request body doesn't match the URL-Id."},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the content asset with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"put":{"description":"Creates a new content asset in the specified library, or overwrites an existing content asset. If a content asset with the specified ID already exists, the server completely overwrites the content asset. Please note: Existing folder assignments are not touched. If the existing content asset is locked, the server returns a 409 (ResourceLockedException) fault. If the connection is not secure, the server returns a 403 (SecureCommunicationRequiredException) fault.","operationId":"putLibrariesByIDContentByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"the ID of the content asset to retrieve.","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/content_asset"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_asset"}},"400":{"description":"Indicates that the ID from the request body doesn't match the URL-Id."},"412":{"description":"Indicates that the ID from the request body doesn't match the URL-Id."},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the content asset with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]}},"/libraries/{library_id}/content/{content_id}/folders":{"get":{"description":"Action to get all assigned folders of a content asset.","operationId":"getLibrariesByIDContentByIDFolders","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"The content id of the assignment.","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"},{"format":"int32","in":"query","minimum":0,"name":"start","type":"integer"},{"format":"int32","in":"query","maximum":200,"minimum":1,"name":"count","type":"integer"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_folder_result"}},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the content asset with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]}},"/libraries/{library_id}/folder_assignments/{content_id}/{folder_id}":{"delete":{"description":"Action to unassign a content asset from the specified library folder.","operationId":"deleteLibrariesByIDFolderAssignmentsByIDByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"the ID of the content asset to retrieve.","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the parent folder with the given id is unknown. or Indicates that the content asset with the given id is unknown. or Indicates that no assignment between the given content asset and folder exists"}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"get":{"description":"Action to get a single content to folder assignment","operationId":"getLibrariesByIDFolderAssignmentsByIDByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"the ID of the content asset to retrieve.","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_folder_assignment"}},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the parent folder with the given id is unknown. or Indicates that the content asset with the given id is unknown. or Indicates that no assignment between the given content asset and folder exists"}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"patch":{"description":"Action to update a single content to folder assignment. Currently only the position and default attribute can be changed.","operationId":"patchLibrariesByIDFolderAssignmentsByIDByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"the content id of the assignment","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/content_folder_assignment"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_folder_assignment"}},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the folder with the given id is unknown. or Indicates that the content asset with the given id is unknown. or Indicates that no assignment between the given content asset and folder exists."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"put":{"description":"Action to assign a content asset to a specified folder.","operationId":"putLibrariesByIDFolderAssignmentsByIDByID","parameters":[{"description":"the ID of the shared library or the site-id in case of a private library","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"the content id","in":"path","maxLength":256,"minLength":1,"name":"content_id","required":true,"type":"string"},{"description":"the folder id","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/content_folder_assignment"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_folder_assignment"}},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the parent folder with the given id is unknown. or Indicates that the content asset with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]}},"/libraries/{library_id}/folders/{folder_id}":{"delete":{"description":"Delete folder","operationId":"deleteLibrariesByIDFoldersByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that library with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"get":{"description":"Action to get folder information.","operationId":"getLibrariesByIDFoldersByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_folder"}},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the folder with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"patch":{"description":"Updates an existing folder. In the request, the If-Match header is required. The value of the header is an 'ETag' representing the last known base-point information for the library folder. If the header is missing, the server returns a 409 (IfMatchRequiredException) fault. If the header value does not match the server's 'ETag', the server returns a 412 (InvalidIfMatchException) fault. The delta information for the library folder is updated atomically: the information is written completely or not at all.","operationId":"patchLibrariesByIDFoldersByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/content_folder"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_folder"}},"400":{"description":"Indicates that a content folder with the ID to change to is already existing."},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the folder with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]},"put":{"description":"Action to create a new library folder, or to replace an existing folder. This action completely overwrites existing folders. Please note: Sub folders and assignments to content assets are not touched. This action ignores the folder ID in the input document.","operationId":"putLibrariesByIDFoldersByID","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/content_folder"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_folder"}},"400":{"description":"Indicates that the ID from the request body doesn't match the URL-Id."},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the parent folder with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]}},"/libraries/{library_id}/folders/{folder_id}/content":{"get":{"description":"Action to get all assigned content assets of a folder.","operationId":"getLibrariesByIDFoldersByIDContent","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"},{"format":"int32","in":"query","minimum":0,"name":"start","type":"integer"},{"format":"int32","in":"query","maximum":200,"minimum":1,"name":"count","type":"integer"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_asset_result"}},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the folder with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]}},"/libraries/{library_id}/folders/{folder_id}/sub_folders":{"get":{"description":"Action to get sub folders information.","operationId":"getLibrariesByIDFoldersByIDSubFolders","parameters":[{"description":"ID of the shared library or the site-id in case of a private library.","in":"path","maxLength":256,"minLength":1,"name":"library_id","required":true,"type":"string"},{"description":"ID of a target folder.","in":"path","maxLength":256,"minLength":1,"name":"folder_id","required":true,"type":"string"},{"format":"int32","in":"query","minimum":0,"name":"start","type":"integer"},{"format":"int32","in":"query","maximum":200,"minimum":1,"name":"count","type":"integer"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/content_sub_folder_result"}},"404":{"description":"Indicates that library with the given id is unknown. or Indicates that the folder with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["libraries"]}},"/locale_info/locales":{"get":{"description":"Action to get the set of active locales for which the user has read or write permission.","operationId":"getLocaleInfoLocales","parameters":[{"description":"optional locale to return by id.  If specified, that locale is looked up and returned, otherwise the\n               list is returned.","in":"query","name":"id","type":"string"},{"description":"the set of fields to return from the request.  Default is only the locale id.","in":"query","name":"select","type":"string"},{"description":"the start index for paging.  Default is 0.","format":"int32","in":"query","name":"start","type":"integer"},{"description":"the count of the records to return in this page.  Default is 25.","format":"int32","in":"query","name":"count","type":"integer"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/locale_result"}}},"security":[{"oauth2_application":[]}],"tags":["locale_info"]}},"/log_requests/ecdn":{"post":{"description":"Requests a LogFile-Fetching for the passed zone and time frame.","operationId":"postLogRequestsEcdn","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/ecdn_log_fetch_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ecdn_log_fetch_response"}}},"security":[{"oauth2_application":[]}],"tags":["log_requests"]}},"/log_requests/ecdn/{id}":{"get":{"description":"Retrieves the current execution status of the log file fetching.","operationId":"getLogRequestsEcdnByID","parameters":[{"description":"ID of the log fetching execution","in":"path","name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ecdn_log_fetch_response"}}},"security":[{"oauth2_application":[]}],"tags":["log_requests"]}},"/ocapi_configs/{clientId}":{"delete":{"description":"Delete a client.","operationId":"deleteOcapiConfigsByID","parameters":[{"description":"Id of the client to be deleted.","in":"path","minLength":1,"name":"clientId","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates that the resulting config is not valid or Write operation on self is not allowed. (The clientId being used for calling this API should be different from target clientId)"},"204":{"description":""}},"security":[{"oauth2_application":[]}],"tags":["ocapi_configs"]},"get":{"description":"Get all allowed resources for the client.","operationId":"getOcapiConfigsByID","parameters":[{"description":"client ID","in":"path","minLength":1,"name":"clientId","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ocapi_configs_api_response"}},"400":{"description":"Indicates that at least one of the existing configs can not be parsed"}},"security":[{"oauth2_application":[]}],"tags":["ocapi_configs"]},"post":{"description":"Add a client to existing OCAPI configurations. Return errors when client already exists.","operationId":"postOcapiConfigsByID","parameters":[{"description":"client ID","in":"path","minLength":1,"name":"clientId","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/ocapi_configs_api_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ocapi_configs_api_response"}},"400":{"description":"Indicates that the resulting config is not valid or Write operation on self is not allowed. (The clientId being used for calling this API should be different from target clientId)"},"404":{"description":"Indicates that at least one of the target sites is unknown"},"409":{"description":"Indicates that the client id already exists in original OCAPI configuration"}},"security":[{"oauth2_application":[]}],"tags":["ocapi_configs"]},"put":{"description":"Add a client to existing OCAPI configurations. Overwrite config if the client already exists.","operationId":"putOcapiConfigsByID","parameters":[{"description":"client ID","in":"path","minLength":1,"name":"clientId","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/ocapi_configs_api_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ocapi_configs_api_response"}},"400":{"description":"Indicates that the resulting config is not valid or Write operation on self is not allowed. (The clientId being used for calling this API should be different from target clientId)"},"404":{"description":"Indicates that at least one of the target sites is unknown"}},"security":[{"oauth2_application":[]}],"tags":["ocapi_configs"]}},"/permissions":{"get":{"description":"Get application specific permissions per type.","operationId":"getPermissions","parameters":[{"description":"The permission expand. A comma separated list with the allowed values (bm, csc).","in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/application_permissions"}}},"security":[{"oauth2_application":[]}],"tags":["permissions"]}},"/permissions/bm":{"get":{"description":"Get Business Manager permissions per type.","operationId":"getPermissionsBm","parameters":[{"description":"The permission expand. A comma separated list with the allowed values \n (module, functional, webdav, locale).","in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/bmpermissions"}}},"security":[{"oauth2_application":[]}],"tags":["permissions"]}},"/permissions/bm/functional":{"get":{"description":"Get functional permissions per scope.","operationId":"getPermissionsBmFunctional","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/functional_permissions"}}},"security":[{"oauth2_application":[]}],"tags":["permissions"]}},"/permissions/bm/locale":{"get":{"description":"Get locale permissions per scope.","operationId":"getPermissionsBmLocale","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/locale_permissions"}}},"security":[{"oauth2_application":[]}],"tags":["permissions"]}},"/permissions/bm/module":{"get":{"description":"Get Business Manager module permissions per scope.","operationId":"getPermissionsBmModule","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/module_permissions"}}},"security":[{"oauth2_application":[]}],"tags":["permissions"]}},"/permissions/bm/webdav":{"get":{"description":"Get WebDAV permissions per scope.","operationId":"getPermissionsBmWebdav","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/webdav_permissions"}}},"security":[{"oauth2_application":[]}],"tags":["permissions"]}},"/permissions/csc":{"get":{"description":"Get permissions per type.","operationId":"getPermissionsCsc","parameters":[{"description":"The permission expand. A comma separated list with the allowed values \n (module, functional, webdav, locale).","in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/cscpermissions"}}},"security":[{"oauth2_application":[]}],"tags":["permissions"]}},"/permissions/csc/module":{"get":{"description":"Get CSC module permissions per scope.","operationId":"getPermissionsCscModule","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/module_permissions"}}},"security":[{"oauth2_application":[]}],"tags":["permissions"]}},"/product_search":{"post":{"description":"Searches for products.\n\n The query attribute specifies a complex query that can be used to narrow down the search. Attributes are grouped\n into different buckets.  These are the list of searchable attributes with their corresponding buckets:\n\n Main:\n \n    id - String\n    name - String\n    online - SiteSpecific Boolean\n    searchable - SiteSpecific Boolean \n    valid_from - SiteSpefic DateTime \n    valid_to - SiteSpecfic DateTime \n    type - ProductType \n    creation_date - DateTime\n \n Catalog:\n \n    catalog_id - String\n \n Category:\n \n    category_id - String\n \n Special:\n \n    type - {\"item\", \"set, \"bundle\", \"master\", \"part_of_product_set\", \"bundled\", \"variant\", \"variation_group\", \"option\", \"retail_set\", \"part_of_retail_set\"}\n \n\n The sortable properties are:\n \n id - String\n name - String\n creation_date - DateTime\n \n\n Note that catalog_id is the id of the catalog to which products are assigned to.\n\n Only attributes in the same bucket can be joined using a disjunction (OR).\n For instance, when joining id and catalog_id above, only a conjunction is allowed (AND), whereas id\n and searchable can be joined using a disjunction because they are in the same bucket.  If an attribute\n is used in a disjunction (OR) that violates this rule, an exception will be thrown.\n\n The product search retrieves additional properties of the product when expansions are used.\n\tThe available expand attribute values are:\n \n        \t'all' will retrieve all the product properties.\n          'availability' will retrieve the following properties:\n            ats\n            in_stock\n            online\n\t\t    \n          'categories' will retrieve the following properties:\n            assigned_categories\n\t\t\t\n          'images' will retrieve the following properties:\n            image\n\t\t\t\n\t\t\t'all_images' used with images will retrieve the following properties:\n            image\n            image_groups\n\t\t\t\n          'prices' will retrieve the following properties:\n            price\n            price_currency\n\t\t\t\n          'sets' will retrieve the following properties:\n            set_products\n            product_sets\n\t\t\t\n          'bundles' will retrieve the following properties:\n            product_bundles\n            bundled_products\n            \n\t\t\t\n\n ","operationId":"postProductSearch","parameters":[{"in":"body","name":"body","schema":{"$ref":"#/definitions/search_request"}},{"description":"The site context.","in":"query","name":"site_id","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_search_result"}},"400":{"description":"Indicates the search query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["product_search"]}},"/products/{id}":{"delete":{"description":"Deletes the product by ID","operationId":"deleteProductsByID","parameters":[{"description":"The product ID.","in":"path","maxLength":100,"minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"get":{"description":"Action to get product information.","operationId":"getProductsByID","parameters":[{"description":"The product ID.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product"}},"404":{"description":"Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"patch":{"description":"Update a product using the information provided.\n\n Fields that can be updated:\n name, page_description, long_descripton, page_title,\n page_keywords, brand, ean,upc, manufacture_sku,\n manufacture_name, searchable, unit, searchable,\n online_flag, default_variant_id.","operationId":"patchProductsByID","parameters":[{"description":"The product ID.","in":"path","maxLength":100,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product"}},"400":{"description":"Indicates there is a problem to set default variant for a product. or Indicates the ID in request URL does not match the ID in the product document."},"404":{"description":"Indicates the product to be updated is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"put":{"description":"Creates a product using the information provided. If a product with the same unique identifier, it will be cleaned and overwritten unless the header x-dw-validate-existing=true is passed in with the request.","operationId":"putProductsByID","parameters":[{"description":"The product ID.","in":"path","maxLength":100,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product"}},"400":{"description":"Indicates the catalog is not provided in the request. or Indicate the product is already existed. or Indicates the ID in request URL does not match the ID in the product document."},"404":{"description":"Indicates the catalog is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{id}/variant_search":{"post":{"description":"Searches product variations for master product or variation group product.\n \n The query attribute specifies a complex query that can be used to narrow down the search. This is the list\n of searchable attributes:\n \n id - String\n product_id - String\n name - String\n online - SiteSpecific Boolean\n in_stock - Boolean \n searchable - SiteSpecific Boolean \n ats - Actual available quantity to sell - Double \n variation_attribute.ATTRIBUTE_ID (Ex:variation_attribute.color) - String\n \n Sortable Fields:\n \n id - String\n product_id - String\n name - String\n online - SiteSpecific Boolean\n in_stock - Boolean \n searchable - SiteSpecific Boolean \n ats - Actual available quantity to sell - Double \n \n\n Note:\n The calculated value of \"online\" and \"searchable\" is used in the search/sort.\n A search/sort by the the site specific attributes require the Site ID query parameter to be set.\n They are \"online\", \"in_stock\", \"searchable\" and \"ats\".\n  We assume that every field that starts with variation_attribute. is searchable and dot is followed by ATTRIBUTE_ID\".\n\n\n The list of expansions to retrieve product information. The expand values available are:\n \t\t  \n \t\t\t_base - Basic product information is retrieved. This expand is included by default.\n \t\t\tall - All product information including the following properties are retrieved:\n        \t\n        \t\timage\n        \t\tprice - site_id has to be provided to see this property\n        \t\tprice_currency - site_id has to be provided to see this property\n        \t\n \t\t\tavailability - Information related to the availability of the product variation.  This expand is not included by default.\n        \t\n        \t\tats - site_id has to be provided to see this property\n        \t\tin_stock - site_id has to be provided to see this property\n        \t\tonline - site_id has to be provided to see this property\n        \t\tsearchable\n        \t\n          variations - Information related to product variation is retrieved. This expand is included by default.\n \t\t\tattributes - Information related to product variation attributes is retrieved. This expand is not included by default.\n \t\t  ","operationId":"postProductsByIDVariantSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}},{"description":"The product id of master product or variation group product","in":"path","name":"id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variant_search_result"}},"400":{"description":"Thrown if the query is ill-formed. or Thrown if the id is not the product id of a Variation Master product or Variation Group product. or Thrown if the Site ID query parameter is missing in the search of Variants by a site-specific product attribute."},"404":{"description":"Thrown if the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{master_product_id}/variation_groups":{"get":{"description":"Reads variation groups for a product master.","operationId":"getProductsByIDVariationGroups","parameters":[{"description":"The id of the master product.","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_groups"}},"400":{"description":"Indicates that the given product is not a variation master."},"404":{"description":"Indicates the master product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{master_product_id}/variation_groups/{id}":{"delete":{"description":"Unassign a variation group product from a product master.  The variation group product is not\n deleted: it remains as a normal product after unsassign.","operationId":"deleteProductsByIDVariationGroupsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"description":"","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates the master product id does not represent a master product. or Indicates product specified is not a variation group."},"204":{"description":""},"404":{"description":"Indicates either the master product or the variation group product cannot be found. or Indicates the product does not belong to the master product."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"get":{"description":"Read a variation group for a product master.","operationId":"getProductsByIDVariationGroupsByID","parameters":[{"description":"The id of the master product that contains the variation group.","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"description":"The id of the variation group product.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_group"}},"400":{"description":"Indicates the master product id does not represent a master product. or Indicates the product specified is not a variation group."},"404":{"description":"Indicates either the master product or the variation group product cannot be found. or Indicates the product does not belong to the master product."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"patch":{"description":"Update a variation group for a product master.","operationId":"patchProductsByIDVariationGroupsByID","parameters":[{"description":"The id of the master product that contains the variation group.","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"description":"The id of the variation group product.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_group"}},"400":{"description":"Indicates the master product id does not represent a master product. or Indicates product specified is not a variation group. or Indicates the values passed are not valid for the variation attributes."},"404":{"description":"Indicates either the master product or the variation group product cannot be found. or Indicates the product does not belong to the master product."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"put":{"description":"Assign a variation group for a product master.  If the variation group product does not initially exist,\n one is created using the body passed in.","operationId":"putProductsByIDVariationGroupsByID","parameters":[{"description":"The id of the master product that contains the variation group.","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"description":"The id of the variation group product.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_group"}},"400":{"description":"Indicates the master product id does not represent a master product. or Indicates the values passed are not valid for the variation attributes."},"404":{"description":"Indicates either the master product or the variation group product cannot be found. or Indicates the value passed into a variation attribute is not one found in the valid values."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{master_product_id}/variations":{"get":{"description":"Reads variation for a product master.","operationId":"getProductsByIDVariations","parameters":[{"description":"The id of the master product.","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variants"}},"400":{"description":"Indicates that the given product is not a variation master."},"404":{"description":"Indicates the master product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{master_product_id}/variations/{id}":{"delete":{"description":"Unassign a variation product from a product master.  The variation product is not deleted: it remains as a\n normal product after unsassign.","operationId":"deleteProductsByIDVariationsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"description":"","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates the master product id does not represent a master product. or Indicates product specified is not a variation."},"204":{"description":""},"404":{"description":"Indicates either the master product or the variation product cannot be found. or Indicates the product does not belong to the master product."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"get":{"description":"Read a variation for a product master.","operationId":"getProductsByIDVariationsByID","parameters":[{"description":"The id of the master product that contains the variation.","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"description":"The id of the variation product.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variant"}},"400":{"description":"Indicates the master product id does not represent a master product. or Indicates the product specified is not a variation."},"404":{"description":"Indicates either the master product or the variation product cannot be found. or Indicates the product does not belong to the master product."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"patch":{"description":"Update a variation for a product master.","operationId":"patchProductsByIDVariationsByID","parameters":[{"description":"The id of the master product that contains the variation.","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"description":"The id of the variation product.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variant"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variant"}},"400":{"description":"Indicates the master product id does not represent a master product. or Indicates product specified is not a variation. or Indicates the values passed are not valid for the variation attributes."},"404":{"description":"Indicates either the master product or the variation product cannot be found. or Indicates the product does not belong to the master product."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"put":{"description":"Assign a variation for a product master.  If the variation product does not initially exist,\n one is created using the body passed in.","operationId":"putProductsByIDVariationsByID","parameters":[{"description":"The id of the master product that contains the variation.","in":"path","minLength":1,"name":"master_product_id","required":true,"type":"string"},{"description":"The id of the variation product.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variant"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variant"}},"400":{"description":"Indicates the master product id does not represent a master product. or Indicates the values passed are not valid for the variation attributes."},"404":{"description":"Indicates either the master product or the variation product cannot be found. or Indicates the value passed into a variation attribute is not one found in the valid values."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{product_id}/product_options":{"get":{"description":"Read local and shared product options of a product.","operationId":"getProductsByIDProductOptions","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","name":"currency","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_options"}},"404":{"description":"Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{product_id}/product_options/{id}":{"delete":{"description":"Deletes a local product option or unbinds a shared product option from the product.","operationId":"deleteProductsByIDProductOptionsByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local or shared product option.","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the local or shared product option is not found. or Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"get":{"description":"Read a local or shared product option of a product.","operationId":"getProductsByIDProductOptionsByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local or shared product option.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"currency","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option"}},"404":{"description":"Indicates the local or shared product option is not found. or Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"patch":{"description":"Updates a local product option with the information provided.","operationId":"patchProductsByIDProductOptionsByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local product option.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_option"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option"}},"400":{"description":"Indicates the shared product option cannot be updated."},"404":{"description":"Indicates the product is not found. or Indicates the local product option is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"put":{"description":"Creates a local product option using the information provided or binds a shared product option to the product.","operationId":"putProductsByIDProductOptionsByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local or shared product option.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_option"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option"}},"400":{"description":"Indicates the local product option cannot be created for a product of type variation group."},"404":{"description":"Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{product_id}/product_options/{option_id}/values":{"get":{"description":"Read local product option values of a local product option in a product.","operationId":"getProductsByIDProductOptionsByIDValues","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option_values"}},"404":{"description":"Indicates the product is not found. or Indicates the local product option is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{product_id}/product_options/{option_id}/values/{id}":{"delete":{"description":"Deletes a local product option value by ID.","operationId":"deleteProductsByIDProductOptionsByIDValuesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"description":"The id of the local product option value.","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the product is not found. or Indicates the local product option is not found. or Indicates the local product option value is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"get":{"description":"Read a local product option value of a local product option in a product.","operationId":"getProductsByIDProductOptionsByIDValuesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"description":"the id of local product option value.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option_value"}},"404":{"description":"Indicates the product is not found. or Indicates the local product option is not found. or Indicates the local product option value is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"patch":{"description":"Updates a local product option value with the information provided.","operationId":"patchProductsByIDProductOptionsByIDValuesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"description":"The id of the local product option value.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_option_value"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option_value"}},"404":{"description":"Indicates the product is not found. or Indicates the local product option is not found. or Indicates the local product option value is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"put":{"description":"Creates a local product option value using the information provided.","operationId":"putProductsByIDProductOptionsByIDValuesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the local product option.","in":"path","minLength":1,"name":"option_id","required":true,"type":"string"},{"description":"The id of the local product option value.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/product_option_value"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/product_option_value"}},"404":{"description":"Indicates the product is not found. or Indicates the local product option is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{product_id}/variation_attributes":{"get":{"description":"Reads variation attributes of a product of type variant or variation master or variation group.","operationId":"getProductsByIDVariationAttributes","parameters":[{"description":"The product ID of a variant or a variation master or a variation group.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attributes"}},"404":{"description":"Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{product_id}/variation_attributes/{attribute_id}/values":{"get":{"description":"Reads variation attribute values of a variation attribute bound to a product.","operationId":"getProductsByIDVariationAttributesByIDValues","parameters":[{"description":"id of the product","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The variation attribute ID that contains the values.","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute_values"}},"400":{"description":"Indicates the master product is not found."},"404":{"description":"Indicates the product is not found. or If the attribute id specified is not a valid product attribute."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{product_id}/variation_attributes/{attribute_id}/values/{id}":{"delete":{"description":"Deletes the variation attribute value of a variation attribute bound to a master product","operationId":"deleteProductsByIDVariationAttributesByIDValuesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the variation attribute that contains the value.","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"description":"The id of one value to remove","in":"path","name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"If the product id specified cannot be found. or If the attribute id specified is not a valid product attribute. or If the value id specified is not a valid value id."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"get":{"description":"Action to get product variation attribute value information.","operationId":"getProductsByIDVariationAttributesByIDValuesByID","parameters":[{"description":"The master product ID.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The variation attribute custom ID","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"description":"The id of the variation attribute value","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"site_id","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute_value"}},"400":{"description":"Indicates the master product is not found."},"404":{"description":"Indicates the product is not found. or If the value id specified is not a valid value id."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"patch":{"description":"Updates the variation attribute value of a variation attribute of a master product.","operationId":"patchProductsByIDVariationAttributesByIDValuesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the requested variation attribute.","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"description":"The id of the variation value.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_attribute_value"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute_value"}},"404":{"description":"If the product id specified cannot be found. or If the attribute id specified is not a valid product attribute. or If the value id specified is not a valid value id."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"put":{"description":"Action to create a product variation attribute value.","operationId":"putProductsByIDVariationAttributesByIDValuesByID","parameters":[{"description":"The master product ID.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The variation attribute ID","in":"path","minLength":1,"name":"attribute_id","required":true,"type":"string"},{"description":"The id of the variation attribute value","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_attribute_value"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute_value"}},"400":{"description":"Indicates the master product is not found."},"404":{"description":"Indicates the product is not found. or If the attribute id specified is not a valid product attribute. or If the value id specified is not a valid value id."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/products/{product_id}/variation_attributes/{id}":{"delete":{"description":"Deletes the variation attribute by ID","operationId":"deleteProductsByIDVariationAttributesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"One variation attribute id to remove","in":"path","name":"id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates the master product is not found."},"204":{"description":""},"404":{"description":"Indicates that the variation attribute is not found. or Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"get":{"description":"Action to get variation attribute information only for master product.","operationId":"getProductsByIDVariationAttributesByID","parameters":[{"description":"The product ID of a variant or a variation master or a variation group.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the requested variation attribute.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute"}},"400":{"description":"Indicates the master product is not found."},"404":{"description":"Indicates that the variation attribute is not found. or Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"patch":{"description":"Updates the variation attribute with the specified information.\n\n \n name\n slicing\n ","operationId":"patchProductsByIDVariationAttributesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the requested variation attribute.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_attribute"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute"}},"400":{"description":"Indicates the master product is not found."},"404":{"description":"Indicates that the variation attribute is not found. or Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]},"put":{"description":"Creates a variation attribute using the information provided.","operationId":"putProductsByIDVariationAttributesByID","parameters":[{"description":"The id of the product.","in":"path","minLength":1,"name":"product_id","required":true,"type":"string"},{"description":"The id of the variation attribute to create.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/variation_attribute"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/variation_attribute"}},"400":{"description":"Indicates that the variation attribute id is not unique. or Indicates that the variation attribute definition is not unique. or Indicates the master product is not found."},"404":{"description":"If attribute definition supplied is not a product attribute. or Indicates the product is not found."}},"security":[{"oauth2_application":[]}],"tags":["products"]}},"/role_search":{"post":{"description":"Searches for access roles.\n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n description - String\n \n Optionally, a user ID (the user login) can be specified. When it is supplied, the search for roles is limited to the\n roles assigned to this user. When expanding the permissions for the roles, all effective permissions for this user can be retrieved.\n\n Optionally, a (single) permission can be specified. When it is supplied, the search for roles is limited to the\n roles having this permission. When expanding the users for the roles, all users having this permission can be retrieved.\n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n description - String\n ","operationId":"postRoleSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/role_search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/role_search_result"}},"400":{"description":"Thrown if the query is ill-formed. or Throws when one of the search request restrictions is violated"}},"security":[{"oauth2_application":[]}],"tags":["role_search"]}},"/roles":{"get":{"description":"Action to get all the access roles with no filtering.","operationId":"getRoles","parameters":[{"description":"Optional start index for retrieving the items from a given index (default 0).","format":"int32","in":"query","name":"start","type":"integer"},{"description":"Optional count for retrieving only a subset of the items (default is 25).","format":"int32","in":"query","name":"count","type":"integer"},{"description":"The property selector.","in":"query","name":"select","type":"string"},{"description":"List of expansions.","in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/roles"}}},"security":[{"oauth2_application":[]}],"tags":["roles"]}},"/roles/{id}":{"delete":{"description":"Action to delete an access role.","operationId":"deleteRolesByID","parameters":[{"description":"The id of the access role to delete.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"403":{"description":"Thrown if deletion of the given role is not allowed"},"404":{"description":"Thrown if the given role does not exist"}},"security":[{"oauth2_application":[]}],"tags":["roles"]},"get":{"description":"Action to get a single access role.","operationId":"getRolesByID","parameters":[{"description":"The id of the requested access role.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/role"}},"404":{"description":"Thrown if the access role with the given id does not exist."}},"security":[{"oauth2_application":[]}],"tags":["roles"]},"put":{"description":"Action to create an access role.","operationId":"putRolesByID","parameters":[{"description":"The id of the access role to create.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/role"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/role"}},"400":{"description":"Thrown when id in query parameter is different from the id in the body."},"403":{"description":"Thrown when an access role with the id \"Support\" or \"Business Support\" should be created."},"409":{"description":"Thrown when an access role with the given id already exists."}},"security":[{"oauth2_application":[]}],"tags":["roles"]}},"/roles/{id}/permissions":{"get":{"description":"Retrieves a list of permissions assigned to the given role.","operationId":"getRolesByIDPermissions","parameters":[{"description":"The id of the requested access role.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/role_permissions"}},"404":{"description":"If the specified access role does not exist."}},"security":[{"oauth2_application":[]}],"tags":["roles"]},"put":{"description":"Assigns permissions to the given role. This will replace the current permission assignments. For the 'Administrator'\n role only adjustments for custom module permissions will be processed but other given permissions will be ignored.","operationId":"putRolesByIDPermissions","parameters":[{"description":"The id of the access role for which the permissions will be set.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/role_permissions"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/role_permissions"}},"400":{"description":"If the type of a given permission does not match the expected type. or If the id of a given permission could not be resolved to a permission. or If a permission value is given that is either unknown or not supported for a certain permission. or If values are given permission multi values are used where only single values are support or vice versa (e.g. setting 'values' attribute of ModulePermissionWO in organization scope). or If no permission for the 'default' locale is given (permission for 'default' locale is mandatory). or If a site specific permission is given for a site that is not known. or If a permission is listed more than once within a scope. or If the 'system' flag is not set for a module permission."},"404":{"description":"If the specified access role does not exist."},"409":{"description":"In case of state token conflicts."}},"security":[{"oauth2_application":[]}],"tags":["roles"]}},"/roles/{id}/user_search":{"post":{"description":"Searches for users of the specified access role.\n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n login - String\n email - String\n first_name - String\n last_name - String\n external_id - String\n last_login_date - Date\n is_locked - Boolean\n is_disabled - Boolean\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n login - String\n email - String\n first_name - String\n last_name - String\n external_id - String\n last_login_date - Date\n ","operationId":"postRolesByIDUserSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}},{"description":"","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/user_search_result"}},"400":{"description":"Thrown if the query is ill-formed."},"404":{"description":"If the specified access role does not exist."}},"security":[{"oauth2_application":[]}],"tags":["roles"]}},"/roles/{id}/users":{"get":{"description":"Action to get all the users assigned to the specified access role.","operationId":"getRolesByIDUsers","parameters":[{"description":"ID of the access role.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/users"}},"404":{"description":"Thrown if the access role with the given id does not exist."}},"security":[{"oauth2_application":[]}],"tags":["roles"]}},"/roles/{id}/users/{login}":{"delete":{"description":"Action to unassign a user to an access role","operationId":"deleteRolesByIDUsersByID","parameters":[{"description":"ID of the access role.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"Login of the user.","in":"path","minLength":1,"name":"login","required":true,"type":"string"}],"responses":{"204":{"description":""},"403":{"description":"Thrown if the admin user is unassigned from the Administrator role."},"404":{"description":"Thrown if the access role with the given id does not exist. or Thrown if a user with the given login does not exist."}},"security":[{"oauth2_application":[]}],"tags":["roles"]},"put":{"description":"Action to assign a user to an access role","operationId":"putRolesByIDUsersByID","parameters":[{"description":"ID of the access role.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"Login of the user.","in":"path","minLength":1,"name":"login","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/user"}},"400":{"description":"Thrown if the access role with the given id does not exist. or Thrown if a user with the given login does not exist."},"403":{"description":"Thrown if the operation is not allowed."}},"security":[{"oauth2_application":[]}],"tags":["roles"]}},"/settings/logging/custom":{"get":{"description":"Action to get custom log settings.","operationId":"getSettingsLoggingCustom","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_log_settings"}}},"security":[{"oauth2_application":[]}],"tags":["settings"]},"patch":{"description":"Updates the custom log settings.","operationId":"patchSettingsLoggingCustom","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/custom_log_settings"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_log_settings"}},"400":{"description":"if the email addresses are invalid. or if one of the categories names are invalid. or if on a production instance the configured level is DEBUG."}},"security":[{"oauth2_application":[]}],"tags":["settings"]}},"/site_preferences/preference_groups/{group_id}/{instance_type}/preference_search":{"post":{"description":"Search preferences across sites in the specified preference group and instance.\n \n The query attribute specifies a complex query that can be used to narrow down the search.\n\n The following is a list of searchable fields:\n\n \n id - String\n display_name - Localized String\n description - Localized String\n value_type* - one of {string, int, double, text, html, date, image, boolean, money, quantity, datetime, email, password, set_of_string, set_of_int, set_of_double, enum_of_string, enum_of_int}\n \n\n * value_type can only be joined with other attributes using a conjunction (AND).\n Note that only searchable attributes can be used in sorting.","operationId":"postSitePreferencesPreferenceGroupsByIDByIDPreferenceSearch","parameters":[{"description":"An instance type, one of {staging,development,sandbox,production}.","in":"path","name":"instance_type","required":true,"type":"string"},{"description":"The ID of the preference group.","in":"path","name":"group_id","required":true,"type":"string"},{"in":"query","name":"mask_passwords","type":"boolean"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/preference_value_search_result"}},"400":{"description":"Indicates the query is ill-formed."},"404":{"description":"Indicates the preference group is not found."}},"security":[{"oauth2_application":[]}],"tags":["site_preferences"]}},"/site_preferences/preference_groups/{group_id}/{instance_type}/preferences/{preference_id}":{"get":{"description":"Get a preference across sites in the specified preference group and instance.","operationId":"getSitePreferencesPreferenceGroupsByIDByIDPreferencesByID","parameters":[{"description":"An instance type, one of {staging,development,sandbox,production}.","in":"path","name":"instance_type","required":true,"type":"string"},{"description":"The ID of the preference group.","in":"path","name":"group_id","required":true,"type":"string"},{"description":"The ID of the preference to retrieve.","in":"path","minLength":1,"name":"preference_id","required":true,"type":"string"},{"in":"query","name":"mask_passwords","type":"boolean"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/preference_value"}},"404":{"description":"Indicates the preference group is not found. or Indicates the preference is not found."}},"security":[{"oauth2_application":[]}],"tags":["site_preferences"]}},"/site_search":{"post":{"description":"Searches for sites.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n display_name - Localized <String>\n description - Localized <String>\n in_deletion - Boolean\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n display_name - Localized <String>\n description - Localized <String>\n in_deletion - Boolean\n ","operationId":"postSiteSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/site_search_result"}},"400":{"description":"Thrown if the query is ill-formed. or Thrown if the invalid value is entered for access_type"}},"security":[{"oauth2_application":[]}],"tags":["site_search"]}},"/sites":{"get":{"description":"Action to get all existing sites.","operationId":"getSites","parameters":[{"description":"Optional start index for retrieving the items from a given index (default 0).","format":"int32","in":"query","name":"start","type":"integer"},{"description":"Optional count for retrieving only a subset of the items (default is 25).","format":"int32","in":"query","name":"count","type":"integer"},{"description":"The property selector.","in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/sites"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}":{"get":{"description":"Action to read an existing site.","operationId":"getSitesByID","parameters":[{"description":"the id of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/site"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/ab_test_search":{"post":{"description":"Searches for A/B Tests. The query attribute specifies a complex query that can be used to narrow down the search. This is the list of searchable attributes:  id - String description - String enabled - Boolean paused - Boolean key_metric_id - String email_addresses - String tags- String expiration_type - String enum[session, never] start_date - DateTime end_date - DateTime  These fields can only be used in Queries as conjunctions (using AND).  If the field is used in a disjunction (OR) an exception will be thrown. The output of the query can also be sorted. These are the list of sortable attributes:  id - String description - String enabled - Boolean paused - Boolean key_metric_id - String ","operationId":"postSitesByIDAbTestSearch","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ab_test_search_result"}},"404":{"description":"Indicates that site specified with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/ab_tests":{"get":{"description":"Action to get all the A/B tests with searching.","operationId":"getSitesByIDAbTests","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"format":"int32","in":"query","minimum":0,"name":"start","type":"integer"},{"format":"int32","in":"query","minimum":0,"name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ab_tests"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/ab_tests/{ab_test_id}/segments/{segment_id}/promotions/{promotion_id}":{"delete":{"description":"Action to unbind one promotions from a given abTest.","operationId":"deleteSitesByIDAbTestsByIDSegmentsByIDPromotionsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The abTest ID that promotions are to be unbound from","in":"path","minLength":1,"name":"ab_test_id","required":true,"type":"string"},{"description":"the segment to bind to","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"description":"The ID of the promotion that is to be assigned to the abTest.","in":"path","minLength":1,"name":"promotion_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that the abTest with the given abTest ID is not found. or thrown when the segment with the given id is not found. or thrown when promotion is not found for one of the specified promotion ids. or thrown when the site with the given id is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a single promotion to a given abTest.","operationId":"putSitesByIDAbTestsByIDSegmentsByIDPromotionsByID","parameters":[{"description":"The ID of the site that contains the abTest and promotion.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the abTest which contains the segment.","in":"path","minLength":1,"name":"ab_test_id","required":true,"type":"string"},{"description":"The ID of the segment to to which the promotion is to be assigned.","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"description":"The ID of the promotion that is to be assigned to the abTest.","in":"path","minLength":1,"name":"promotion_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that the abTest with the given abTest ID is not found. or thrown when the segment with the given id is not found. or Indicates that the promotion with the given promotion ID is not found. or thrown when the site with the given id is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/ab_tests/{ab_test_id}/segments/{segment_id}/slot_configurations/{slot_id}/{slot_config_id}":{"delete":{"description":"Action to unbind a slot configuration from a given abTest.","operationId":"deleteSitesByIDAbTestsByIDSegmentsByIDSlotConfigurationsByIDByID","parameters":[{"description":"The id of the abTest","in":"path","minLength":1,"name":"ab_test_id","required":true,"type":"string"},{"description":"","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"description":"The id of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The of the slot","in":"path","minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The id of the slot configuration","in":"path","minLength":1,"name":"slot_config_id","required":true,"type":"string"},{"in":"query","minLength":1,"name":"context","type":"string"}],"responses":{"400":{"description":"Indicates the slot context type is not one of \"global\", \"category\", or \"folder\""},"204":{"description":""},"404":{"description":"Indicates that the abTest with the given abTest ID is not found. or Indicates that the slot with the given slot ID and context type is not found. or Indicates that the slot with the given slot ID, slot configuration ID and context type is not found. or thrown when the segment with the given id is not found. or thrown when the site with the given id is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a slot configuration to a given abTest.","operationId":"putSitesByIDAbTestsByIDSegmentsByIDSlotConfigurationsByIDByID","parameters":[{"description":"The id of the abTest","in":"path","minLength":1,"name":"ab_test_id","required":true,"type":"string"},{"description":"","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"description":"The id of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The of the slot","in":"path","minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The id of the slot configuration","in":"path","minLength":1,"name":"slot_config_id","required":true,"type":"string"},{"in":"query","minLength":1,"name":"context","type":"string"}],"responses":{"400":{"description":"Indicates the slot context type is not one of \"global\", \"category\", or \"folder\""},"204":{"description":""},"404":{"description":"Indicates that the abTest with the given abTest ID is not found. or Indicates that the slot with the given slot ID and context type is not found. or Indicates that the slot with the given slot ID, slot configuration ID and context type is not found. or thrown when the segment with the given id is not found. or thrown when the site with the given id is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/ab_tests/{ab_test_id}/segments/{segment_id}/sorting_rules/{sorting_rule_id}/{category_id}":{"delete":{"description":"Action to unbind a single sorting rule from a given abTest.","operationId":"deleteSitesByIDAbTestsByIDSegmentsByIDSortingRulesByIDByID","parameters":[{"description":"The ID of the site that contains the abTest, sorting rule and category.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the abTest to which the sorting rule is to be assigned.","in":"path","minLength":1,"name":"ab_test_id","required":true,"type":"string"},{"description":"","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"description":"The ID of sorting rule that is to be assigned to the abTest.","in":"path","minLength":1,"name":"sorting_rule_id","required":true,"type":"string"},{"description":"The ID of the category that is associated with the sorting rule.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"in":"query","name":"rule_context","type":"string"}],"responses":{"400":{"description":"Indicates that the category with the given category ID is not found."},"204":{"description":""},"404":{"description":"Indicates that the abTest with the given abTest ID is not found. or Indicates that the sorting rule with the given sorting rule ID is not found. or thrown when the segment with the given id is not found. or thrown when the site with the given id is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a single sorting rule to a given abTest.","operationId":"putSitesByIDAbTestsByIDSegmentsByIDSortingRulesByIDByID","parameters":[{"description":"The ID of the site that contains the abTest, sorting rule and category.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the abTest to which the sorting rule is to be assigned.","in":"path","minLength":1,"name":"ab_test_id","required":true,"type":"string"},{"description":"","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"description":"The ID of sorting rule that is to be assigned to the abTest.","in":"path","minLength":1,"name":"sorting_rule_id","required":true,"type":"string"},{"description":"The ID of the category that is associated with the sorting rule.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"in":"query","name":"rule_context","type":"string"}],"responses":{"400":{"description":"Indicates that the category with the given category ID is not found."},"204":{"description":""},"404":{"description":"Indicates that the abTest with the given abTest ID is not found. or Indicates that the sorting rule with the given sorting rule ID is not found. or thrown when the segment with the given id is not found. or thrown when the site with the given id is not found."},"409":{"description":"Indicates that there is a sorting rule already assigned to the given abTest ID and category ID.\n              The sorting rule with the given sorting rule ID cannot be assigned to the same abTest ID and category ID."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/ab_tests/{id}":{"delete":{"description":"Deletes the A/B Test by ID","operationId":"deleteSitesByIDAbTestsByID","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested A/B Test.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that site specified with the given id is unknown. or Thrown in case the A/B Test does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to get an A/B Test information.","operationId":"getSitesByIDAbTestsByID","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested A/B Test.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ab_test"}},"404":{"description":"Indicates that site specified with the given id is unknown. or Thrown in case the A/B Test does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the A/B Test with the specified information.","operationId":"patchSitesByIDAbTestsByID","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested A/B Test.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/ab_test"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ab_test"}},"400":{"description":"Thrown if an invalid email is specified. or Thrown if an invalid pipeline is specified. or Thrown if there is missing pipline_call or categories in the specified trigger of type pipeline_call or category_view_page respectively."},"404":{"description":"Indicates that site specified with the given id is unknown. or Thrown in case the A/B Test does not exist matching the given id"},"409":{"description":"Thrown if an A/B Test exists already in the site with the given identifier specified in the body that is different from the identifier in the path."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates an A/B Test using the information provided. If an A/B Test with the same unique identifier exists, it will be deleted and a new one will be created unless the header x-dw-validate-existing=true is passed in with the request.","operationId":"putSitesByIDAbTestsByID","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested A/B Test.","in":"path","maxLength":40,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/ab_test"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ab_test"}},"400":{"description":"Thrown if an invalid email is specified. or Thrown if an invalid pipeline is specified. or Thrown if there is missing pipline_call or categories in the specified trigger of type pipeline_call or category_view_page respectively."},"404":{"description":"Indicates that site specified with the given id is unknown. or Thrown in case the A/B Test does not exist matching the given id"},"409":{"description":"If an A/B Test exists already in the site with the given identifier and the header\nx-dw-validate-existing=true is passed in with the request."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/ab_tests/{id}/segments/{segment_id}":{"delete":{"description":"Deletes the A/B Test Segment by ID","operationId":"deleteSitesByIDAbTestsByIDSegmentsByID","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested A/B Test.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"The id of the segment in the test.","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates that site specified with the given id is unknown. or Thrown in case the A/B Test does not exist matching the given id or Thrown if the segment cannot be found in the A/B Test provided"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Gets an A/B Test segment using the information provided.","operationId":"getSitesByIDAbTestsByIDSegmentsByID","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested A/B Test.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"The id of the segment in the test.","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ab_test_segment"}},"404":{"description":"Indicates that site specified with the given id is unknown. or Thrown in case the A/B Test does not exist matching the given id or Thrown if the segment cannot be found in the A/B Test provided"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the A/B Test segment with the specified information.","operationId":"patchSitesByIDAbTestsByIDSegmentsByID","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested A/B Test.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"The id of the segment in the test.","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/ab_test_segment"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ab_test_segment"}},"404":{"description":"Indicates that site specified with the given id is unknown. or Thrown in case the A/B Test does not exist matching the given id or Thrown if the segment cannot be found in the A/B Test provided"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates an A/B Test segment using the information provided.","operationId":"putSitesByIDAbTestsByIDSegmentsByID","parameters":[{"description":"ID of the site that the A/B tests are contained within.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested A/B Test.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"The id of the segment in the test.","in":"path","minLength":1,"name":"segment_id","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/ab_test_segment"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/ab_test_segment"}},"404":{"description":"Indicates that site specified with the given id is unknown. or Thrown in case the A/B Test does not exist matching the given id or Thrown if the segment cannot be found in the A/B Test provided"}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/ai/recommender_names":{"get":{"description":"Get a list of available AI recommenders. Recommenders are configured in the Einstein configurator and are required with AI recommendation API requests.","operationId":"getSitesByIDAiRecommenderNames","parameters":[{"description":"Site ID to get a list of recommenders for.","in":"path","maxLength":256,"minLength":1,"name":"site_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/recommenders_result"}},"400":{"description":"If CQuotient responds with a non-success status code."},"404":{"description":"If the given site does not exist."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/campaign_search":{"post":{"description":"Searches for campaigns.\n \n The Campaign Search document contains a search object that allows filtering on various attributes.\n \n\n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n     campaign_id - String\n     description - String\n     enabled - Boolean\n     coupon_id* - String\n     customer_group* - String\n     source_code* - String\n     start_date - Date\n     end_date - Date\n     last_modified - Date\n     \n \n\n These fields can only be used in Queries as conjunctions (using AND).  If the field is used in a disjunction\n (OR) an exception will be thrown.\n\n Note that only searchable attributes (excluding the ones marked with above with an asterisk) can be used in sorting\n Additionally start_date, end_date and last_modified cannot be used in sorting.","operationId":"postSitesByIDCampaignSearch","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/campaign_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/campaigns/{campaign_id}":{"delete":{"description":"Deletes the campaign by ID","operationId":"deleteSitesByIDCampaignsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"A campaign id to remove","in":"path","name":"campaign_id","required":true,"type":"string"}],"responses":{"204":{"description":""}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to get campaign information.","operationId":"getSitesByIDCampaignsByID","parameters":[{"description":"The site the requested campaign belongs to.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested campaign.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/campaign"}},"404":{"description":"Thrown in case the campaign does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the campaign with the specified information.","operationId":"patchSitesByIDCampaignsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested campaign.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/campaign"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/campaign"}},"400":{"description":"if a campaign exists already in the site with the given campaign id."},"404":{"description":"Thrown in case the campaign does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates a campaign using the information provided.","operationId":"putSitesByIDCampaignsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the campaign to create.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/campaign"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/campaign"}},"400":{"description":"if the Id in request is not the same as the ID in document."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/campaigns/{campaign_id}/coupons/{coupon_id}":{"delete":{"description":"Action to unbind a coupon from a given campaign.","operationId":"deleteSitesByIDCampaignsByIDCouponsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The campaign ID that coupons are to be unbound from","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The coupon ID to unbind from a campaign","in":"path","minLength":1,"name":"coupon_id","required":true,"type":"string"},{"in":"query","name":"removeInPCA","type":"string"}],"responses":{"400":{"description":"Indicates some parameter constraint violation occurs"},"204":{"description":""},"404":{"description":"Indicates that the campaign with the given campaign id\n \t\t\t\tis unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a single coupon to a given campaign.","operationId":"putSitesByIDCampaignsByIDCouponsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The campaign ID that coupons are to be bound to","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The coupon ID to bind to a campaign","in":"path","minLength":1,"name":"coupon_id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates some parameter constraint violation occurs"},"204":{"description":""},"404":{"description":"Indicates that the campaign with the given campaign id\n \t\t\t\tis unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/campaigns/{campaign_id}/customer_groups/{customer_group_id}":{"delete":{"description":"Action to unbind a customer group from a given campaign.","operationId":"deleteSitesByIDCampaignsByIDCustomerGroupsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The campaign ID that coupons are to be unbound from","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The customer group ID to unbind from a campaign","in":"path","minLength":1,"name":"customer_group_id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates some parameter constraint violation occurs"},"204":{"description":""},"404":{"description":"Indicates that the campaign with the given campaign id\n              is unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a single customer group to a given campaign.","operationId":"putSitesByIDCampaignsByIDCustomerGroupsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The campaign ID that coupons are to be bound to","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The customer group ID to bind to a campaign","in":"path","minLength":1,"name":"customer_group_id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates some parameter constraint violation occurs"},"204":{"description":""},"404":{"description":"Indicates that the campaign with the given campaign id\n              is unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/campaigns/{campaign_id}/promotions/{promotion_id}":{"delete":{"description":"Action to unbind a single promotion from a given campaign.","operationId":"deleteSitesByIDCampaignsByIDPromotionsByID","parameters":[{"description":"The ID of the site that contains the campaign and promotion.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the campaign to which the promotion is to be assigned.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The ID of the promotion that is to be assigned to the campaign.","in":"path","minLength":1,"name":"promotion_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"thrown when site with the given site id is not found. or Indicates that the campaign with the given campaign ID is not found. or Indicates that the campaign with the given promotion ID is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a single promotion to a given campaign.","operationId":"putSitesByIDCampaignsByIDPromotionsByID","parameters":[{"description":"The ID of the site that contains the campaign and promotion.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the campaign to which the promotion is to be assigned.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The ID of the promotion that is to be assigned to the campaign.","in":"path","minLength":1,"name":"promotion_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"thrown when site with the given site id is not found. or Indicates that the campaign with the given campaign ID is not found. or Indicates that the promotion with the given promotion ID is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/campaigns/{campaign_id}/slot_configurations/{slot_id}/{slot_config_id}":{"delete":{"description":"Action to unbind a slot configuration from a given campaign.","operationId":"deleteSitesByIDCampaignsByIDSlotConfigurationsByIDByID","parameters":[{"description":"The id of the campaign","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The id of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The of the slot","in":"path","minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The id of the slot configuration","in":"path","minLength":1,"name":"slot_config_id","required":true,"type":"string"},{"in":"query","minLength":1,"name":"context","type":"string"}],"responses":{"400":{"description":"Indicates the slot context type is not one of \"global\", \"category\", or \"folder\""},"204":{"description":""},"404":{"description":"thrown when site with the given site id is not found. or Indicates that the campaign with the given campaign ID is not found. or Indicates that the slot with the given slot ID and context type is not found. or Indicates that the slot with the given slot ID, slot configuration ID and context type is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Action to update the assignment of slot configuration to a campaign.","operationId":"patchSitesByIDCampaignsByIDSlotConfigurationsByIDByID","parameters":[{"description":"The ID of the campaign.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the slot.","in":"path","minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The ID of the slot configuration.","in":"path","minLength":1,"name":"slot_config_id","required":true,"type":"string"},{"in":"query","minLength":1,"name":"context","type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/slot_configuration_campaign_assignment"}}],"responses":{"400":{"description":"Indicates the slot context type is not one of \"global\", \"category\", or \"folder\""},"204":{"description":""},"404":{"description":"thrown when site with the given site id is not found. or Indicates that the campaign with the given campaign ID is not found. or Indicates that the slot with the given slot ID and context type is not found. or Indicates that the slot with the given slot ID, slot configuration ID and context type is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a slot configuration to a given campaign.","operationId":"putSitesByIDCampaignsByIDSlotConfigurationsByIDByID","parameters":[{"description":"The ID of the campaign.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the slot.","in":"path","minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The ID of the slot configuration.","in":"path","minLength":1,"name":"slot_config_id","required":true,"type":"string"},{"in":"query","minLength":1,"name":"context","type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/slot_configuration_campaign_assignment"}}],"responses":{"400":{"description":"Indicates the slot context type is not one of \"global\", \"category\", or \"folder\" or Indicates the ID in the URL does not match the ID in the request"},"204":{"description":""},"404":{"description":"thrown when site with the given site id is not found. or Indicates that the campaign with the given campaign ID is not found. or Indicates that the slot with the given slot ID and context type is not found. or Indicates that the slot with the given slot ID, slot configuration ID and context type is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/campaigns/{campaign_id}/sorting_rules/{sorting_rule_id}/{category_id}":{"delete":{"description":"Action to unbind a single sorting rule from a given campaign.","operationId":"deleteSitesByIDCampaignsByIDSortingRulesByIDByID","parameters":[{"description":"The ID of the site that contains the campaign, sorting rule and category.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the campaign to which the sorting rule is to be assigned.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The ID of sorting rule that is to be assigned to the campaign.","in":"path","minLength":1,"name":"sorting_rule_id","required":true,"type":"string"},{"description":"The ID of the category that is associated with the sorting rule.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"in":"query","name":"rule_context","type":"string"}],"responses":{"400":{"description":"Indicates that the category with the given category ID is not found."},"204":{"description":""},"404":{"description":"thrown when site with the given site id is not found. or Indicates that the campaign with the given campaign ID is not found. or Indicates that the sorting rule with the given sorting rule ID is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a single sorting rule to a given campaign.","operationId":"putSitesByIDCampaignsByIDSortingRulesByIDByID","parameters":[{"description":"The ID of the site that contains the campaign, sorting rule and category.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The ID of the campaign to which the sorting rule is to be assigned.","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The ID of sorting rule that is to be assigned to the campaign.","in":"path","minLength":1,"name":"sorting_rule_id","required":true,"type":"string"},{"description":"The ID of the category that is associated with the sorting rule.","in":"path","minLength":1,"name":"category_id","required":true,"type":"string"},{"in":"query","name":"rule_context","type":"string"}],"responses":{"400":{"description":"Indicates that the category with the given category ID is not found."},"204":{"description":""},"404":{"description":"thrown when site with the given site id is not found. or Indicates that the campaign with the given campaign ID is not found. or Indicates that the sorting rule with the given sorting rule ID is not found."},"409":{"description":"Indicates that there is a sorting rule already assigned to the given campaign ID and category ID.\n              The sorting rule with the given sorting rule ID cannot be assigned to the same campaign ID and category ID."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/campaigns/{campaign_id}/source_code_groups/{source_code_group_id}":{"delete":{"description":"Action to unbind a source code group from a given campaign.","operationId":"deleteSitesByIDCampaignsByIDSourceCodeGroupsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The campaign ID that source code groups are to be unbound from","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The source code group ID to unbind from a campaign","in":"path","minLength":1,"name":"source_code_group_id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates some parameter constraint violation occurs"},"204":{"description":""},"404":{"description":"Indicates that the campaign with the given campaign id\n              is unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to bind a single source code group to a given campaign.","operationId":"putSitesByIDCampaignsByIDSourceCodeGroupsByID","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The campaign ID that source code group are to be bound to","in":"path","minLength":1,"name":"campaign_id","required":true,"type":"string"},{"description":"The source code group ID to bind to a campaign","in":"path","minLength":1,"name":"source_code_group_id","required":true,"type":"string"}],"responses":{"400":{"description":"Indicates some parameter constraint violation occurs"},"204":{"description":""},"404":{"description":"Indicates that the campaign with the given campaign id\n              is unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/cartridges":{"post":{"description":"Add a cartridge to current cartridge path.","operationId":"postSitesByIDCartridges","parameters":[{"description":"ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/cartridge_path_add_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/cartridge_path_api_response"}},"400":{"description":"The error may happen when position is either 'after' or 'before'. It indicates either target cartridge is not a existing custom cartridge. or Indicates that the cartridge already exist in cartridge path or Indicates that the cartridge name is invalid"},"404":{"description":"Indicates that site specified with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Overwrite cartridge path.","operationId":"putSitesByIDCartridges","parameters":[{"description":"ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/cartridge_path_create_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/cartridge_path_api_response"}},"400":{"description":"Indicates that the cartridge path is invalid"},"404":{"description":"Indicates that site specified with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/cartridges/{cartridge_name}":{"delete":{"description":"Remove a cartridge from cartridge path.","operationId":"deleteSitesByIDCartridgesByID","parameters":[{"description":"ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"request body","in":"path","minLength":1,"name":"cartridge_name","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/cartridge_path_api_response"}},"400":{"description":"It indicates either the cartridge doesn't exist in cartridge path or the cartridge can not be deleted (e.g. System Cartridge)."},"404":{"description":"Indicates that site specified with the given id is unknown."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupon_redemption_search":{"post":{"description":"Searches for coupon redemptions.\n \n The Coupon Redemption Search document contains a search object that allows filtering on various attributes.\n \n\n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n     code - String\n     coupon_id - String\n     customer_email - String\n     order_no - String\n \n\n Note that only searchable attributes can be used in sorting.\n\n If the role to which the user belongs does not have View_Coupon_Codes permission, then the coupon codes returned will be masked.","operationId":"postSitesByIDCouponRedemptionSearch","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/coupon_redemption_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupon_search":{"post":{"description":"Searches for coupons.\n\n The Coupon Search document contains a search object that allows filtering on various attributes.\n\n\n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n coupon_id - String\n description - String\n type - one of {\"single_code\", \"multiple_codes\", \"system_codes\"}\n enabled - boolean\n \n\n Note that only searchable attributes can be used in sorting.\n\n The stats expand value is required to return the following fields in the Coupon document:\n \n     exported_code_count\n     redemption_count\n     total_codes_count\n ","operationId":"postSitesByIDCouponSearch","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/coupon_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupons":{"get":{"description":"Action to get all the coupons with no filtering.","operationId":"getSitesByIDCoupons","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/coupons"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupons/{coupon_id}":{"delete":{"description":"Delete a coupon by id.","operationId":"deleteSitesByIDCouponsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"Id of the coupon to delete from the site.","in":"path","minLength":1,"name":"coupon_id","required":true,"type":"string"}],"responses":{"204":{"description":""}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to get coupon information.\n\n The following fields are returned in the Coupon document when specifying the stats expand:\n \n     exported_code_count\n     redemption_count\n     total_codes_count\n \n \n\n If the role to which the user belongs does not have View_Coupon_Codes permission, then the coupon codes returned will be masked.","operationId":"getSitesByIDCouponsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested coupon.","in":"path","minLength":1,"name":"coupon_id","required":true,"type":"string"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/coupon"}},"404":{"description":"Thrown in case the coupon does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the coupon with the specified information.","operationId":"patchSitesByIDCouponsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested coupon.","in":"path","minLength":1,"name":"coupon_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/coupon"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/coupon"}},"400":{"description":"Thrown if you try to update certain fields in a coupon after\n              redeeming or exporting it. or Thrown if the code provided is in use by another coupon. or Thrown whenever a quota regarding system-generated coupons is violated"},"403":{"description":"Thrown when trying to update a broken coupon, that should be deleted and re-created. or Thrown when trying to update a legacy coupon."},"404":{"description":"Thrown if the coupon does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates a coupon using the information provided. If a coupon exists with the same unique identifier,\n the coupon is replaced completely.","operationId":"putSitesByIDCouponsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the coupon to create.","in":"path","minLength":1,"name":"coupon_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/coupon"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/coupon"}},"400":{"description":"Thrown if the coupon passed in is not valid (the argument indicates\n              the field that was invalid). or Thrown if the code provided is in use by another coupon. or Thrown if a single code coupon does not set the coupon code properly. or if the Id in request is not the same as the ID in document. or Thrown whenever a quota regarding system-generated coupons is violated"},"403":{"description":"Thrown if the resource requires global instead of site-specific context."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupons/{coupon_id}/campaigns":{"get":{"description":"Get the campaigns that have a coupon assigned to them either directly or through promotions","operationId":"getSitesByIDCouponsByIDCampaigns","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the coupon that is assigned to campaigns directly or through promotions.","in":"path","name":"coupon_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/campaigns"}},"404":{"description":"Thrown if the coupon does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupons/{coupon_id}/campaigns/{campaign_id}/promotions":{"get":{"description":"Get the promotions for a campaign that have a coupon assigned to them either directly or through campaigns.","operationId":"getSitesByIDCouponsByIDCampaignsByIDPromotions","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the coupon that is assigned to promotions directly or through campaigns.","in":"path","name":"coupon_id","required":true,"type":"string"},{"description":"The id of the campaign that we want to restrict the set of promotions for.","in":"path","name":"campaign_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/promotions"}},"404":{"description":"Thrown if the coupon does not exist matching the given id. or Thrown if the campaign does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupons/{coupon_id}/codes":{"get":{"description":"Get the coupon codes for the given coupon.\n\n If the role to which the user belongs does not have View_Coupon_Codes permission, then the coupon codes returned will be masked.","operationId":"getSitesByIDCouponsByIDCodes","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the coupon from which to delete codes (must be a multiple code coupon).","in":"path","name":"coupon_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/coupon_codes"}},"404":{"description":"Thrown if the coupon does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupons/{coupon_id}/multiple_codes":{"post":{"description":"Add or delete (modify) multiple codes to/from the supplied coupon.","operationId":"postSitesByIDCouponsByIDMultipleCodes","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the coupon to modify codes (must be multiple code coupon).","in":"path","name":"coupon_id","required":true,"type":"string"},{"in":"query","name":"delete","type":"boolean"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/coupon_multi_codes_request"}}],"responses":{"400":{"description":"Thrown if the coupon code could not be created."},"204":{"description":""},"404":{"description":"Thrown if the coupon does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/coupons/{coupon_id}/promotions":{"get":{"description":"Get the promotions that have a coupon assigned to them either directly or through campaigns.","operationId":"getSitesByIDCouponsByIDPromotions","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the coupon that is assigned to promotions directly or through campaigns.","in":"path","name":"coupon_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/promotions"}},"404":{"description":"Thrown if the coupon does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/custom_objects/{object_type}/{key}":{"delete":{"description":"Deletes a site specific Custom Object. If the Custom Object does not exist, this will do nothing. Note that the customization scripts are only called, if the Custom Object does exist.","operationId":"deleteSitesByIDCustomObjectsByIDByID","parameters":[{"description":"the ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"the ID of the object type","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"description":"the key attribute value of the Custom Object","in":"path","minLength":1,"name":"key","required":true,"type":"string"}],"responses":{"400":{"description":"If the object key must be an integer, but the path parameter has an invalid format"},"204":{"description":""},"404":{"description":"For an unknown object type ID"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Reads a site specific Custom Object with a given object type ID and a value for the key attribute of the object which represents its unique identifier.","operationId":"getSitesByIDCustomObjectsByIDByID","parameters":[{"description":"the ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"the ID of the object type","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"description":"the key attribute value of the Custom Object","in":"path","minLength":1,"name":"key","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_object"}},"400":{"description":"If the object key must be an integer, but the path parameter has an invalid format"},"404":{"description":"For an unknown object key or For an unknown object type ID"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates a site specific Custom Object with information from request body. Note that only mentioned attributes will be updated and the key attribute is ignored. All other attributes will be left unattended.","operationId":"patchSitesByIDCustomObjectsByIDByID","parameters":[{"description":"the ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"the ID of the object type","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"description":"the key attribute value of the Custom Object","in":"path","minLength":1,"name":"key","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/custom_object"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_object"}},"400":{"description":"If the object key must be an integer, but the path parameter has an invalid format"},"404":{"description":"For an unknown object key or For an unknown object type ID"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates a site specific Custom Object from request body for the specified site. Note that an existing Custom Object for the site, with the same key, will be overwritten by this action.","operationId":"putSitesByIDCustomObjectsByIDByID","parameters":[{"description":"the ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"the ID of the object type","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"},{"description":"the key attribute value of the Custom Object","in":"path","minLength":1,"name":"key","required":true,"type":"string"},{"in":"body","name":"body","schema":{"$ref":"#/definitions/custom_object"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/custom_object"}},"400":{"description":"If the object key must be an integer, but the path parameter has an invalid format"},"404":{"description":"For an unknown object key or For an unknown object type ID"}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/customer_group_search":{"post":{"description":"Searches for customer groups.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n description - String\n type - String Enum value[system, dynamic, static]\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n description - String\n ","operationId":"postSitesByIDCustomerGroupSearch","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group_search_result"}},"400":{"description":"Thrown if the search term in term query does not match any of the customer group type. or Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/customer_groups":{"get":{"description":"Action to get all the customer groups with no filtering.","operationId":"getSitesByIDCustomerGroups","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_groups"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/customer_groups/{id}":{"delete":{"description":"Triggers customer group deletion by ID. Be aware that the deletion happens via asynchronous batch process\n which is the reason the deletion itself is not necessarily finished after the call to this resource returned. The \n customer group that is in deletion will be provided in the response.","operationId":"deleteSitesByIDCustomerGroupsByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"One customer group id to remove","in":"path","name":"id","required":true,"type":"string"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group"}},"403":{"description":"Thrown when attempting to delete the system customer group."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to get customer group information.","operationId":"getSitesByIDCustomerGroupsByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested customer group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group"}},"404":{"description":"Thrown in case the customer group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the customer group with the specified information.","operationId":"patchSitesByIDCustomerGroupsByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested customer group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/customer_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group"}},"403":{"description":"Thrown when attempting to update the system customer group."},"404":{"description":"Thrown in case the customer group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates a customer group using the information provided.","operationId":"putSitesByIDCustomerGroupsByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the customer group to create.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/customer_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group"}},"400":{"description":"Thrown when there are system error in creating the customer group. or Thrown when id in query parameter is different from the id in the body."},"403":{"description":"Thrown when attempting to create the system customer group."},"409":{"description":"if a customer group exists already in the site with the given identifier."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/customer_groups/{id}/member_search":{"post":{"description":"Searches for customer group members. For dynamic customer groups and the system groups \"Everyone\" and \"Unregistered\" no result is returned (Status Code: 204 - No Content).\n\n The query attribute specifies a complex query that can be used to narrow down the search. Attributes are grouped\n into different buckets.  These are the list of searchable attributes with their corresponding buckets:\n\n Main:\n \n      login - String\n      active - Boolean\n \n Customer Profile:\n \n      customer_no - String\n      first_name - String\n      last_name - String\n      email - String\n      zip - String\n \n\n Only attributes in the same bucket can be joined using a disjunction (OR).\n For instance, when joining login and customer_no above, only a conjunction is allowed (AND), whereas customer_no\n and email can be joined using a disjunction because they are in the same bucket.  If an attribute\n is used in a disjunction (OR) that violates this rule, an exception will be thrown.\n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n customer_no - String\n login - String\n \n\n If the Business manager customer search is configured to use the new Search Service, the following differences apply:\n \n     all attributes can be used for sorting (except for 'active')\n     searching for 'zip' will only search in the customers default address\n     logical operators can be used without limits (but may result in degraded performance, depending on how they are combined)\n     new assignments might not be found immediately via the search service, and removed assignments\n     might also not be in effect immediately (there is a slight delay in updating the index)\n ","operationId":"postSitesByIDCustomerGroupsByIDMemberSearch","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested members customer group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group_member_search_result"}},"400":{"description":"Thrown if the query is ill-formed."},"404":{"description":"Thrown in case the customer group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/customer_groups/{id}/members":{"get":{"description":"Action to get all the customer group members with no filtering. For dynamic customer groups and the system groups \"Everyone\" and \"Unregistered\" no result is returned (Status Code: 204 - No Content).","operationId":"getSitesByIDCustomerGroupsByIDMembers","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group_members"}},"404":{"description":"Thrown in case the customer group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/customer_groups/{id}/members/{customer_no}":{"delete":{"description":"Action to remove a customer from a (static) customer group.","operationId":"deleteSitesByIDCustomerGroupsByIDMembersByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the customer group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"The customer number of the customer to remove from the group.","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"in":"query","name":"select","type":"string"}],"responses":{"204":{"description":""},"403":{"description":"Thrown when the customer group is not a static group."},"404":{"description":"Thrown in case the customer group does not exist matching the given id. or Thrown in case the customer list did not exist, or the customer does not exist in the list."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to get customer group member information.","operationId":"getSitesByIDCustomerGroupsByIDMembersByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested members customer group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"The customer number of the requested customer group member.","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group_member"}},"404":{"description":"Thrown in case the customer group does not exist matching the given id or Thrown in case the customer group member did not exist, or the group is not a static group"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Action to add customer to (static) customer group.","operationId":"putSitesByIDCustomerGroupsByIDMembersByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the customer group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"description":"The customer number of the customer to add to the group.","in":"path","minLength":1,"name":"customer_no","required":true,"type":"string"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/customer_group_member"}},"403":{"description":"Thrown when the customer group is not a static group."},"404":{"description":"Thrown in case the customer group does not exist matching the given id. or Thrown in case the customer list did not exist, or the customer does not exist in in the list."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/gift_certificate_search":{"post":{"description":"Searches for gift certificates.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n merchant_id - String\n masked_gift_certificate_code* - String\n order_no - String\n sender_name - String\n recipient_name - String\n recipient_email - String\n status - String\n enabled - Boolean\n message - String\n description - String\n creation_date - Date\n currency_mnemonic* - String\n \n\n * masked_gift_certificate_code, also known as just code, can only be used in a term query.  If a\n four-character code is supplied, it is assumed that the search is on the unmasked portion of the code, otherwise\n the full code must be matched.  Text queries are not allowed.\n\n * currency_mnemonic can only be joined with other attributes using a conjunction (AND).\n\n Note that only searchable attributes can be used in sorting.  The code attribute cannot be used for sorting.","operationId":"postSitesByIDGiftCertificateSearch","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/gift_certificate_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/gift_certificates":{"get":{"description":"Action to get all the gift certificates with no filtering.","operationId":"getSitesByIDGiftCertificates","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/gift_certificates"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"post":{"description":"Creates a gift certificate using the information provided. If a gift certificate with \n the same unique identifier, it will be deleted and a new one will be created.","operationId":"postSitesByIDGiftCertificates","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/gift_certificate"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/gift_certificate"}},"400":{"description":"if the gift certificate passed in is not valid (the \n              argument indicates the field that was invalid). or If the amount specified is out of range or If merchant id is not unique or If recipient email address is invalid or If gift certificate status specified is invalid"}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/gift_certificates/{merchant_id}":{"delete":{"description":"Deletes the gift certificate by merchant ID","operationId":"deleteSitesByIDGiftCertificatesByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"One gift certificate merchant id to remove","in":"path","name":"merchant_id","required":true,"type":"string"}],"responses":{"204":{"description":""}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to get gift certificate information using merchant ID.","operationId":"getSitesByIDGiftCertificatesByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The merchant id of the requested gift certificate.","in":"path","minLength":1,"name":"merchant_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/gift_certificate"}},"404":{"description":"Thrown in case the gift certificate does not exist matching the given merchant id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the gift certificate with the specified information using merchant ID.","operationId":"patchSitesByIDGiftCertificatesByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The merchant id of the requested gift certificate.","in":"path","minLength":1,"name":"merchant_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/gift_certificate"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/gift_certificate"}},"400":{"description":"If recipient email address is invalid or If gift certificate status specified is invalid"},"404":{"description":"Thrown in case the gift certificate does not exist matching the given merchant id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/locale_info/locales":{"get":{"description":"Action to get the set of locales with the system given a site.","operationId":"getSitesByIDLocaleInfoLocales","parameters":[{"in":"query","name":"include_all","type":"boolean"},{"in":"query","name":"id","type":"string"},{"in":"query","name":"select","type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"description":"Only locales specified for the site are returned","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/locale_result"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}":{"patch":{"description":"Updates the order.","operationId":"patchSitesByIDOrdersByID","parameters":[{"description":"ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/order_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/confirmation_status":{"put":{"description":"Updates the order confirmation status.","operationId":"putSitesByIDOrdersByIDConfirmationStatus","parameters":[{"description":"ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/order_confirmation_status_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/export_status":{"put":{"description":"Updates the order export status. Setting the status to EXPORTED will also trigger the finalization of on-order inventory transactions for this order, meaning that all inventory transactions with type on-order will be moved into final inventory transactions. This is only relevant when on-order inventory is turned on for the inventory list ordered products are in.","operationId":"putSitesByIDOrdersByIDExportStatus","parameters":[{"description":"ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/order_export_status_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/external_status":{"put":{"description":"Updates the order external status.","operationId":"putSitesByIDOrdersByIDExternalStatus","parameters":[{"description":"ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/order_external_status_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/payment_instruments/{payment_instrument_id}":{"patch":{"description":"Updates the payment instrument of an order.","operationId":"patchSitesByIDOrdersByIDPaymentInstrumentsByID","parameters":[{"description":"ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"description":"ID of the payment instrument","in":"path","minLength":1,"name":"payment_instrument_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/payment_instrument_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site. or In case of the given payment_instrument_id does not reference an existing payment instrument."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/payment_instruments/{payment_instrument_id}/transaction":{"patch":{"description":"Updates the transaction of an order payment instrument.","operationId":"patchSitesByIDOrdersByIDPaymentInstrumentsByIDTransaction","parameters":[{"description":"ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"description":"ID of the payment instrument","in":"path","minLength":1,"name":"payment_instrument_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/payment_transaction_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site. or In case of the given payment_instrument_id does not reference an existing payment instrument. or In case of the payment instrument does not reference a payment transaction."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/payment_status":{"put":{"description":"Updates the order payment status.","operationId":"putSitesByIDOrdersByIDPaymentStatus","parameters":[{"description":"ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/order_payment_status_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/shipments/{shipment_id}/shipping_address":{"put":{"description":"Updates (create or replace) the order shipment address.","operationId":"putSitesByIDOrdersByIDShipmentsByIDShippingAddress","parameters":[{"description":"ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"description":"ID of the shipment","in":"path","minLength":1,"name":"shipment_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/shipping_address_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site. or In case of the given shipment_id does not reference an existing shipment."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/shipping_status":{"put":{"description":"Updates the order shipping status.","operationId":"putSitesByIDOrdersByIDShippingStatus","parameters":[{"description":"ID of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/order_shipping_status_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/orders/{order_no}/status":{"put":{"description":"Updates the order status by using the corresponding methods (fail, undoFail, place, cancel and undoCancel) from the dw.order.OrderMgr. Orders which are not in status CREATED or FAILED can not be set back.","operationId":"putSitesByIDOrdersByIDStatus","parameters":[{"description":"ID of the site","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The order number","in":"path","minLength":1,"name":"order_no","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/order_status_update_request"}}],"responses":{"204":{"description":""},"404":{"description":"In case of the given order_no does not reference an existing order. or In case of the given site_id does not reference an existing site."},"409":{"description":"The status change is not supported. or The order could not be cancelled. or The order could not be placed. or The cancelled order can not be reopened. or The failed order can not be reopened."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/promotion_campaign_assignment_search":{"post":{"description":"Searches for promotion campaign assignments.\n \n The PromotionCampaignAssignment Search document contains a search object that allows filtering on various attributes.\n \n The query attribute specifies a complex query that can be used to narrow down the search. Attributes are grouped\n into different buckets.  These are the list of searchable attributes with their corresponding buckets:\n\n Main:\n \n     rank - Integer\n     start_date - Date\n     end_date - Date\n \n Campaign:\n \n     campaign_id - String\n \n Promotion:\n \n     promotion_id - String\n     description - String\n     enabled - Boolean\n \n Special handling:\n \n     coupon_id - String\n \n\n Only fields in the same bucket can be joined using a disjunction (OR). For instance, when joining\n campaign_id and rank above, only a conjunction is allowed (AND), whereas promotion_id and description can be\n joined to each other using an OR because they are in the same bucket.  Special handling fields must always use\n conjunctions. If the field is used in a disjunction (OR) that violates this rule, an exception will be thrown.\n\n Expands that can be applied for the search request\n \n \t   promotion\n     campaign\n \n\n Note that only searchable attributes (excluding the ones marked with above with an asterisk) can be used in sorting.","operationId":"postSitesByIDPromotionCampaignAssignmentSearch","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/promotion_campaign_assignment_search_result"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/promotion_search":{"post":{"description":"Searches for promotions.\n \n The SearchRequest document contains a search object that allows filtering on various attributes.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the searchable\n attributes:\n \n id - String\n name - String\n currency_code - String\n exclusivity - String\n enabled - Boolean\n \n Note that only searchable attributes can be used in sorting. Additionally, the following attribute can be used to\n sort:\n \n promotion_class - String\n ","operationId":"postSitesByIDPromotionSearch","parameters":[{"description":"The site context.","in":"path","name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/promotion_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/promotions/{id}":{"delete":{"description":"Deletes the promotion by ID","operationId":"deleteSitesByIDPromotionsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"Promotion id to remove","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to get promotion information.","operationId":"getSitesByIDPromotionsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested promotion.","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/promotion"}},"404":{"description":"Thrown in case the promotion does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the promotion with the specified information.","operationId":"patchSitesByIDPromotionsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested promotion.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/promotion"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/promotion"}},"404":{"description":"Thrown in case the promotion does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates a promotion using the information provided.","operationId":"putSitesByIDPromotionsByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the promotion to create.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/promotion"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/promotion"}},"400":{"description":"if the Id in request is not the same as the ID in document."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/site_preferences/preference_groups/{group_id}/{instance_type}":{"get":{"description":"For the specified site and instance, read the custom preferences in the preference group.\n Specify 'current' to retrieve the preferences for the instance on which this call is being made. The system will recognize its type.","operationId":"getSitesByIDSitePreferencesPreferenceGroupsByIDByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"One of {staging,development,sandbox,production,current}.","in":"path","name":"instance_type","required":true,"type":"string"},{"description":"The ID of the preference group.","in":"path","name":"group_id","required":true,"type":"string"},{"in":"query","name":"mask_passwords","type":"boolean"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/site_preferences"}},"404":{"description":"Indicates the preference group is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"For the specified site and instance, update one or more custom preferences in the preference group.\n Preferences of type password cannot be set to \"************\" since it is a reserved value.","operationId":"patchSitesByIDSitePreferencesPreferenceGroupsByIDByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"One of {staging,development,sandbox,production}.","in":"path","name":"instance_type","required":true,"type":"string"},{"description":"The ID of the preference group.","in":"path","name":"group_id","required":true,"type":"string"},{"in":"query","name":"mask_passwords","type":"boolean"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/site_preferences"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/site_preferences"}},"404":{"description":"Indicates the preference group is not found. or Indicates the SitePreferences system object is not found."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/slot_configuration_campaign_assignment_search":{"post":{"description":"Searches for slotconfiguration campaign assignments.\n \n The SlotConfigCampaignAssignment Search document contains a search object that allows filtering on various attributes.\n\n The query attribute specifies a complex query that can be used to narrow down the search. Attributes are grouped\n into different buckets.  These are the list of searchable attributes with their corresponding buckets:\n\n Main:\n \n     rank - Integer\n     start_date - Date\n     end_date - Date\n \n Campaign:\n \n     campaign_id - String\n     enabled - Boolean\n \n Slot configuration:\n \n     slot_configuration_id - String\n     description - String\n \n\n Only attributes in the same bucket can be joined using a disjunction (OR).\n For instance, when joining rank and description above, only a conjunction is allowed (AND), whereas slot_configuration_id\n and description can be joined using a disjunction because they are in the same bucket.  If an attribute\n is used in a disjunction (OR) that violates this rule, an exception will be thrown.\n\n Expands that can be applied for the search request\n \n \t   campaign\n \t   slotConfiguration\t\n \n\n Note that only searchable attributes (excluding the ones marked with above with an asterisk) can be used in sorting.","operationId":"postSitesByIDSlotConfigurationCampaignAssignmentSearch","parameters":[{"description":"The site context.","in":"path","name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slot_configuration_campaign_assignment_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/slot_configuration_search":{"post":{"description":"Searches for slot configurations.\n\n The query attribute specifies a complex query that can be used to narrow down the search. Attributes are grouped\n into different buckets.  These are the list of searchable attributes with their corresponding buckets:\n\n Main:\n \n    configuration_id - String\n    default - Boolean\n    description - String\n    enabled - Boolean\n \n Slot:\n \n    context - String\n    slot_id - String\n \n\n Only fields in the same bucket can be joined using a disjunction (OR). For instance, when joining context and\n description above, only a conjunction is allowed (AND), whereas context and slot_id can be joined to each other\n using a disjunction because they are in the same bucket.  If the field is used in a disjunction (OR) that\n violates this rule, an exception will be thrown.","operationId":"postSitesByIDSlotConfigurationSearch","parameters":[{"description":"The site context.","in":"path","name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slot_configuration_search_result"}},"400":{"description":"Indicates that the value to search with does not match the\n              type of the search field."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/slot_configurations":{"get":{"description":"Action to get all the slot configurations with no filtering.","operationId":"getSitesByIDSlotConfigurations","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slot_configurations"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/slot_search":{"post":{"description":"Searches for slots.\n \n The query attribute specifies a complex query that can be used to narrow down the search. The set of fields that\n are available to search are:\n \n slot_id - String\n description - String\n context_type - String \n \n\n Note that only searchable attributes can be used in sorting. \"context_type\" value is restricted to Global/Folder/Category.","operationId":"postSitesByIDSlotSearch","parameters":[{"description":"The site context.","in":"path","name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slot_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/slots":{"get":{"description":"Action to get all the slots with no filtering.","operationId":"getSitesByIDSlots","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slots"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/slots/{slot_id}/slot_configurations/{configuration_id}":{"delete":{"description":"Removes a configuration for slot in a given context from a site.","operationId":"deleteSitesByIDSlotsByIDSlotConfigurationsByID","parameters":[{"description":"The id of the site for which you want to create the slot configuration.","in":"path","maxLength":32,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the slot.","in":"path","maxLength":256,"minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The id of the slot configuration.","in":"path","maxLength":256,"minLength":1,"name":"configuration_id","required":true,"type":"string"},{"in":"query","name":"context","type":"string"}],"responses":{"400":{"description":"Thrown if the specified context type is invalid."},"204":{"description":""},"404":{"description":"Throw if there was no slot with the specified id found for the \n              requested site."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to read an existing slot configuration.","operationId":"getSitesByIDSlotsByIDSlotConfigurationsByID","parameters":[{"description":"The id of the site for which you want to create the slot configuration.","in":"path","maxLength":32,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the slot.","in":"path","maxLength":256,"minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The id of the slot configuration.","in":"path","maxLength":256,"minLength":1,"name":"configuration_id","required":true,"type":"string"},{"in":"query","name":"context","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slot_configuration"}},"400":{"description":"Thrown if the specified context type is invalid. or Thrown if the specified context id for given context 'category' or 'folder' is missing."},"404":{"description":"Throw if there was no slot with the specified id found for the \n              requested site. or Thrown if there was no slot configuration found for the specified\n              configuration id."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates an existing slot configuration. This action ignores the slot_id and\n the context information in the input document. Note that this operation will\n not touch any relational properties, which means, that e.g. the rank on a specific\n campaign assignment will not be changed, when the rank for the slot configuration\n itself is updated.","operationId":"patchSitesByIDSlotsByIDSlotConfigurationsByID","parameters":[{"description":"The id of the site for which you want to create the slot configuration.","in":"path","maxLength":32,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the slot.","in":"path","maxLength":256,"minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The id of the slot configuration.","in":"path","maxLength":256,"minLength":1,"name":"configuration_id","required":true,"type":"string"},{"in":"query","name":"context","type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/slot_configuration"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slot_configuration"}},"400":{"description":"Thrown if the specified context id for given context 'category' or 'folder' is missing. or Thrown if the specified context type is invalid."},"404":{"description":"Thrown if there was no slot with the given id found for the \n              requested site. or Thrown if there was no slot configuration found for the specified configuration \n              id. or Thrown if content asset does not exist in the library of the current domain\n              but is assigned during update."},"409":{"description":"Thrown if the configuration ID should be updated into one that is already\n              assigned."}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates a new configuration for an existing slot. If a slot configuration\n exists with the specified configuration_id, slot_id, and context, the existing\n slot configuration is overwritten.","operationId":"putSitesByIDSlotsByIDSlotConfigurationsByID","parameters":[{"description":"The id of the site for which you want to create the slot configuration.","in":"path","maxLength":32,"minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the slot.","in":"path","maxLength":256,"minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The id of the slot configuration.","in":"path","maxLength":256,"minLength":1,"name":"configuration_id","required":true,"type":"string"},{"in":"query","name":"context","type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/slot_configuration"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slot_configuration"}},"400":{"description":"Thrown if the specified context type is invalid. or Thrown if the specified context id for given context 'category' or 'folder' is missing. or if the Id in request is not the same as the ID in document."},"404":{"description":"Thrown if there was no slot with the given id found for the \n              requested site. or Thrown if content asset does not exist in the library of the current domain\n              but is assigned during creation of the configuration."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/slots/{slot_id}/{context_type}":{"get":{"description":"Action to get slot information.","operationId":"getSitesByIDSlotsByIDByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested slot.","in":"path","minLength":1,"name":"slot_id","required":true,"type":"string"},{"description":"The context type (folder, global, category).","in":"path","name":"context_type","required":true,"type":"string"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/slot"}},"404":{"description":"Indicates the slot does not exist matching the given id."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/sorting_rule_search":{"post":{"description":"Searches for product sorting rules.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n description - String\n creation_date - date of creation\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n description - String\n creation_date - date of creation\n \n\n This resource does not support expand options.","operationId":"postSitesByIDSortingRuleSearch","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}},{"in":"query","name":"rule_context","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/sorting_rule_search_result"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/source_code_group_search":{"post":{"description":"Searches for source code groups.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n description - String\n source_code* - String \n start_time - DateTime\n end_time - DateTime\n creation_date - DateTime\n enabled - Boolean\n active* - Boolean \n \n\n * - These fields can only be used in Queries as conjunctions (using AND).  If the field is used in a disjunction\n (OR) an exception will be thrown.\n \n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n description - String\n enabled - Boolean\n creation_date - DateTime\n \n \n Expands that can be applied for the search request\n \n specifications - String\n ","operationId":"postSitesByIDSourceCodeGroupSearch","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/source_code_group_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/source_code_groups":{"get":{"description":"Action to get all the source code groups with no filtering.","operationId":"getSitesByIDSourceCodeGroups","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/source_code_groups"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/source_code_groups/{id}":{"delete":{"description":"Deletes the source code group by ID","operationId":"deleteSitesByIDSourceCodeGroupsByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"One source code group id to remove","in":"path","maxLength":28,"minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to retrieve source code group information.","operationId":"getSitesByIDSourceCodeGroupsByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested source code group.","in":"path","maxLength":28,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/source_code_group"}},"404":{"description":"Thrown in case the source code group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the source code group with the specified information.","operationId":"patchSitesByIDSourceCodeGroupsByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested source code group.","in":"path","maxLength":28,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/source_code_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/source_code_group"}},"404":{"description":"Thrown in case the source code group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates a source code group using the information provided.","operationId":"putSitesByIDSourceCodeGroupsByID","parameters":[{"description":"The id of the site.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the source code group to create.","in":"path","maxLength":28,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/source_code_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/source_code_group"}},"400":{"description":"if the source code group passed in is not valid (the argument indicates the field that was invalid). or Thrown when the id given in request URL is different from the id provided in the source code group document"}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/store_search":{"post":{"description":"Searches for stores.\n \n The query attribute specifies a complex query that can be used to narrow down the search. This is the list\n of searchable attributes:\n \n address1 - String\n address2 - String\n city - String\n country_code - String\n email - String\n fax - String\n id - String\n inventory_id - String\n latitude - double\n longitude - double\n name - String\n phone - String\n postal_code - String\n state_code - String\n store_hours - String\n store_events - String\n ","operationId":"postSitesByIDStoreSearch","parameters":[{"description":"The site context.","in":"path","name":"site_id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/store_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/stores":{"get":{"description":"Action to get all the stores with no filtering.","operationId":"getSitesByIDStores","parameters":[{"description":"","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/stores"}}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/sites/{site_id}/stores/{id}":{"delete":{"description":"Deletes the store by ID","operationId":"deleteSitesByIDStoresByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"One store id to remove","in":"path","maxLength":256,"minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Thrown in case the store does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"get":{"description":"Action to get store information.","operationId":"getSitesByIDStoresByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested store.","in":"path","maxLength":256,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/store"}},"404":{"description":"Thrown in case the store does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"patch":{"description":"Updates the store with the specified information.","operationId":"patchSitesByIDStoresByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the requested store.","in":"path","maxLength":256,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/store"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/store"}},"404":{"description":"Thrown in case the store does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["sites"]},"put":{"description":"Creates a store using the information provided.","operationId":"putSitesByIDStoresByID","parameters":[{"description":"The site context.","in":"path","minLength":1,"name":"site_id","required":true,"type":"string"},{"description":"The id of the store to create.","in":"path","maxLength":256,"minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/store"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/store"}},"400":{"description":"if the Id in request is not the same as the ID in document."}},"security":[{"oauth2_application":[]}],"tags":["sites"]}},"/system_object_definition_search":{"post":{"description":"Searches for system objects.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n object_type - String\n display_name - Localized<String>\n description - Localized<String>\n read_only - Boolean\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n object_type - String\n display_name - Localized<String>\n description - Localized<String>\n read_only - Boolean\n ","operationId":"postSystemObjectDefinitionSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_type_definition_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["system_object_definition_search"]}},"/system_object_definitions":{"get":{"description":"Action to get all the system objects with no filtering.","operationId":"getSystemObjectDefinitions","parameters":[{"description":"Optional start index for retrieving the items from a given index (default 0).","format":"int32","in":"query","name":"start","type":"integer"},{"description":"Optional count for retrieving only a subset of the items (default is 25).","format":"int32","in":"query","name":"count","type":"integer"},{"description":"The property selector.","in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_type_definitions"}}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/system_object_definitions/{object_type}":{"get":{"description":"Action to get system object information.","operationId":"getSystemObjectDefinitionsByID","parameters":[{"description":"The id of the object type for the requested system object.","in":"path","minLength":1,"name":"object_type","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_type_definition"}},"404":{"description":"Thrown in case the system object does not exist matching the given objectType"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/system_object_definitions/{object_type}/attribute_definition_search":{"post":{"description":"Searches the attribute definitions of the specified system object type.\n \n The query attribute specifies a complex query that can be used to narrow down the search. Attributes are grouped\n into different buckets.  These are the list of searchable attributes with their corresponding buckets:\n\n Main:\n \n    id - String\n    display_name* - Localized String\n    description* - Localized String\n    key - boolean\n    mandatory - boolean\n    searchable - boolean\n    system - boolean\n    visible - boolean\n \n Definition version:\n \n    localizable - boolean\n    site_specific - boolean\n    value_type - one of {string, int, double, text, html, date, image, boolean, money, quantity, datetime, email, password, set_of_string, set_of_int, set_of_double, enum_of_string, enum_of_int}\n \n Group:\n \n    group - String\n \n\n Only attributes in the same bucket can be joined using a disjunction (OR).\n For instance, when joining localizable and description above, only a conjunction is allowed (AND), whereas display_name\n and description can be joined using a disjunction because they are in the same bucket.  If an attribute\n is used in a disjunction (OR) that violates this rule, an exception will be thrown.\n\n * These attributes are not searchable or sortable for built in system attributes.  They work normally for non\n system attributes.\n\n Note that only searchable attributes can be used in sorting.","operationId":"postSystemObjectDefinitionsByIDAttributeDefinitionSearch","parameters":[{"description":"The object type id that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definition_search_result"}},"400":{"description":"Indicates the query is ill-formed."},"404":{"description":"in case the object type does not match an existing system type"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/system_object_definitions/{object_type}/attribute_definitions":{"get":{"description":"Action to get all the attribute definitions with no filtering.","operationId":"getSystemObjectDefinitionsByIDAttributeDefinitions","parameters":[{"description":"","in":"path","name":"object_type","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definitions"}},"404":{"description":"in case the object type does not match an existing system type"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/system_object_definitions/{object_type}/attribute_definitions/{id}":{"delete":{"description":"Deletes the attribute definition by ID","operationId":"deleteSystemObjectDefinitionsByIDAttributeDefinitionsByID","parameters":[{"description":"The metadata object that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"description":"Attribute definition id to remove","in":"path","minLength":1,"name":"id","required":true,"type":"string"}],"responses":{"400":{"description":"Thrown when trying to delete an internal attribute definition"},"204":{"description":""},"404":{"description":"Thrown in case the object type cannot be found or Thrown in case the attribute definition cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]},"get":{"description":"Action to get attribute definition information.","operationId":"getSystemObjectDefinitionsByIDAttributeDefinitionsByID","parameters":[{"description":"The object type id that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the requested attribute definition.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definition"}},"404":{"description":"in case the object type does not match an existing system type or Thrown in case the attribute definition does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]},"patch":{"description":"Updates the attribute definition with the specified information. The request must include the If-Match header, which holds\n the last known base-point information. The value of this header is an \"ETag\" representing the attribute definition state. If\n the request does not contain an If-Match header with the current server customer \"ETag\", a 409 (IfMatchRequiredException)\n fault is returned. If the If-Match header does not match the current server attribute definition \"ETag\", a 412 (InvalidIfMatchException)\n fault is returned.","operationId":"patchSystemObjectDefinitionsByIDAttributeDefinitionsByID","parameters":[{"description":"The object type id that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the requested attribute definition.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"header","name":"If-Match","type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/object_attribute_definition"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definition"}},"400":{"description":"Thrown when trying to modify a read-only field of an internal\n    attribute definition"},"404":{"description":"Thrown in case the attribute definition does not exist matching the given id or Thrown in case the object type cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]},"put":{"description":"Creates a attribute definition using the information provided.","operationId":"putSystemObjectDefinitionsByIDAttributeDefinitionsByID","parameters":[{"description":"The metadata object that contains these definitions","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the attribute definition to create.","in":"path","name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/object_attribute_definition"}},{"in":"header","name":"x-dw-validate-existing","type":"boolean"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_definition"}},"400":{"description":"if the attribute definition could not be created. or Thrown when trying to create an internal attribute definition or if a attribute definition exists already with the given attribute definition id. or if the Id in request is not the same as the ID in document."},"404":{"description":"Thrown in case the object type cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/system_object_definitions/{object_type}/attribute_group_search":{"post":{"description":"Searches for attribute groups.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n id - String\n display_name - Localized<String>\n description - Localized<String>\n position - Double\n internal - Boolean\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n id - String\n display_name - Localized<String>\n description - Localized<String>\n position - Double\n internal - Boolean\n ","operationId":"postSystemObjectDefinitionsByIDAttributeGroupSearch","parameters":[{"description":"","in":"path","name":"object_type","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_group_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/system_object_definitions/{object_type}/attribute_groups":{"get":{"description":"Action to get all the attribute groups with no filtering.","operationId":"getSystemObjectDefinitionsByIDAttributeGroups","parameters":[{"description":"","in":"path","name":"object_type","required":true,"type":"string"},{"format":"int32","in":"query","name":"start","type":"integer"},{"format":"int32","in":"query","name":"count","type":"integer"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_groups"}},"404":{"description":"in case the object type does not match an existing system type"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/system_object_definitions/{object_type}/attribute_groups/{group_id}/attribute_definitions/{def_id}":{"delete":{"description":"Un-assign an attribute definition from an attribute group.","operationId":"deleteSystemObjectDefinitionsByIDAttributeGroupsByIDAttributeDefinitionsByID","parameters":[{"description":"The ID of the system object that contains the attribute definition and attribute group.","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The ID of the attribute group.","in":"path","minLength":1,"name":"group_id","required":true,"type":"string"},{"description":"The ID of the attribute definition.","in":"path","minLength":1,"name":"def_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the specified system object is not found. or Indicates the specified attribute group is not found. or Indicates the specified attribute definition is not found."}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]},"put":{"description":"Assign an attribute definition to an attribute group.","operationId":"putSystemObjectDefinitionsByIDAttributeGroupsByIDAttributeDefinitionsByID","parameters":[{"description":"The ID of the system object that contains the attribute definition and attribute group.","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The ID of the attribute group.","in":"path","minLength":1,"name":"group_id","required":true,"type":"string"},{"description":"The ID of the attribute definition.","in":"path","minLength":1,"name":"def_id","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"Indicates the specified system object is not found. or Indicates the specified attribute group is not found. or Indicates the specified attribute definition is not found."}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/system_object_definitions/{object_type}/attribute_groups/{id}":{"delete":{"description":"Deletes the attribute group by ID","operationId":"deleteSystemObjectDefinitionsByIDAttributeGroupsByID","parameters":[{"description":"the object type id that contains this attribute gorup","in":"path","name":"object_type","required":true,"type":"string"},{"description":"One attribute group id to remove","in":"path","name":"id","required":true,"type":"string"}],"responses":{"400":{"description":"Thrown when trying to delete an internal attribute group"},"204":{"description":""},"404":{"description":"Thrown in case the object type cannot be found or Thrown in case the attribute group cannot be found"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]},"get":{"description":"Action to get attribute group information.","operationId":"getSystemObjectDefinitionsByIDAttributeGroupsByID","parameters":[{"description":"the object type id that contains this attribute group","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the requested attribute group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"query","name":"select","type":"string"},{"in":"query","items":{"type":"string"},"name":"expand","type":"array"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_group"}},"404":{"description":"in case the object type does not match an existing system type or Thrown in case the attribute group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]},"patch":{"description":"Updates the attribute group with the specified information. The request must include the If-Match header, which holds\n the last known base-point information. The value of this header is an \"ETag\" representing the attribute group state. If\n the request does not contain an If-Match header with the current server customer \"ETag\", a 409 (IfMatchRequiredException)\n fault is returned. If the If-Match header does not match the current server attribute group \"ETag\", a 412 (InvalidIfMatchException)\n fault is returned.","operationId":"patchSystemObjectDefinitionsByIDAttributeGroupsByID","parameters":[{"description":"the object type id that contains this attribute gorup","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the requested attribute group.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"header","name":"If-Match","type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/object_attribute_group"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_group"}},"400":{"description":"Thrown when trying to modify an attribute of a field of an attribute group\n     that is read only"},"404":{"description":"Thrown in case the attribute group does not exist matching the given id"}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]},"put":{"description":"Creates a attribute group using the information provided. If a attribute group with the same unique identifier, it will be deleted and a new one will be created unless the header x-dw-validate-existing=true is passed in with the request.","operationId":"putSystemObjectDefinitionsByIDAttributeGroupsByID","parameters":[{"description":"the object type id that contains this attribute gorup","in":"path","name":"object_type","required":true,"type":"string"},{"description":"The id of the attribute group to create.","in":"path","minLength":1,"name":"id","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/object_attribute_group"}},{"in":"header","name":"x-dw-validate-existing","type":"boolean"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/object_attribute_group"}},"400":{"description":"Thrown when trying to create an internal attribute group or if a attribute group exists already in the site with the given identifier and the header x-dw-validate-existing=true is passed in with the request."}},"security":[{"oauth2_application":[]}],"tags":["system_object_definitions"]}},"/user_search":{"post":{"description":"Searches for users.\n \n The query attribute specifies a complex query that can be used to narrow down the search. These are the list\n of searchable attributes:\n \n \n login - String\n email - String\n first_name - String\n last_name - String\n external_id - String\n last_login_date - Date\n is_locked - Boolean\n is_disabled - Boolean\n \n\n The output of the query can also be sorted. These are the list of sortable attributes:\n \n login - String\n email - String\n first_name - String\n last_name - String\n external_id - String\n last_login_date - Date\n ","operationId":"postUserSearch","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/search_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/user_search_result"}},"400":{"description":"Thrown if the query is ill-formed."}},"security":[{"oauth2_application":[]}],"tags":["user_search"]}},"/users":{"get":{"description":"Action to get all users with no filtering.","operationId":"getUsers","parameters":[{"description":"Optional start index for retrieving the items from a given index (default 0).","format":"int32","in":"query","name":"start","type":"integer"},{"description":"Optional count for retrieving only a subset of the items (default is 25).","format":"int32","in":"query","name":"count","type":"integer"},{"description":"The property selector.","in":"query","name":"select","type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/users"}}},"security":[{"oauth2_application":[]}],"tags":["users"]}},"/users/this":{"get":{"description":"Action to get the user password expiration information.","operationId":"getUsersThis","responses":{"default":{"description":"","schema":{"$ref":"#/definitions/user"}},"401":{"description":"If the user provided by the OAuth token cannot be found. or If the user profile is currently locked."}},"security":[{"oauth2_application":[]}],"tags":["users"]}},"/users/this/password":{"patch":{"description":"Action to change a user password.","operationId":"patchUsersThisPassword","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/password_change_request"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/user"}},"400":{"description":"If the new password doesn't meet the acceptance crtiteria of a user password. or If the same new password was set recently before. or If the provided current user password is invalid."},"401":{"description":"If the user provided by the OAuth token cannot be found. or If the user profile is currently locked."}},"security":[{"oauth2_application":[]}],"tags":["users"]}},"/users/{login}":{"delete":{"description":"Action to delete a single user.","operationId":"deleteUsersByID","parameters":[{"description":"login of the user","in":"path","minLength":1,"name":"login","required":true,"type":"string"}],"responses":{"204":{"description":""},"404":{"description":"If no user with the specified login could be found."}},"security":[{"oauth2_application":[]}],"tags":["users"]},"get":{"description":"Action to get a user.","operationId":"getUsersByID","parameters":[{"description":"login of the user","in":"path","minLength":1,"name":"login","required":true,"type":"string"}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/user"}},"404":{"description":"If no user with the specified login could be found."}},"security":[{"oauth2_application":[]}],"tags":["users"]},"patch":{"description":"Action to update a user.\n\n Note: The locked flag and the user password cannot be updated with this resource.","operationId":"patchUsersByID","parameters":[{"description":"login of the user","in":"path","minLength":1,"name":"login","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/user"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/user"}},"400":{"description":"If the login in the request URL is different from the login in the request body. or If either the Preferred UI Locale or the Preferred Data Locale are unknown. or If another user with the same external id already exists. or If the external id is explicitly set to null for an externally managed user"},"403":{"description":"If creation or replacement of a user with the given login is not allowed."},"404":{"description":"If no user with the specified login could be found."}},"security":[{"oauth2_application":[]}],"tags":["users"]},"put":{"description":"Action to create or overwrite a user.\n\n If a user with the given login already exists, the existing user will be overwritten.\n If no such login exists, a new user is created.","operationId":"putUsersByID","parameters":[{"description":"login of the user","in":"path","minLength":1,"name":"login","required":true,"type":"string"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/user"}}],"responses":{"default":{"description":"","schema":{"$ref":"#/definitions/user"}},"400":{"description":"If the password doesn't meet the acceptance crtiteria of a user password. or If the login in the request URL is different from the login in the request body. or If either the Preferred UI Locale or the Preferred Data Locale are unknown. or If password or external id of the user are invalid. or If another user with the same external id already exists. or If creation of a local Business Manager user is not allowed with the current server settings."},"403":{"description":"If creation or replacement of a user with the given login is not allowed."}},"security":[{"oauth2_application":[]}],"tags":["users"]}}},"produces":["application/json","text/xml","application/xml"],"securityDefinitions":{"oauth2_application":{"description":"Authentication flow with client ID and password with account manager.","flow":"application","tokenUrl":"https://account.demandware.com:443/dw/oauth2/access_token","type":"oauth2"}},"swagger":"2.0"}