API Reference
  1. WSHOP API
  2. Facets

Bulk create or update facet pages

put
https://{instance}.wshop.cloud/api/v1/facets/bulk

Creates or updates several facet pages in a single transaction: if one item fails, nothing is saved. An item whose id matches an existing facet page is updated; any other item is created and must then satisfy the creation constraints (category_id, conditions, site_id, translations with url and title). translations is required on every item. IDs must be unique in the payload (FACET0016).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer

ID of the facet page to update. Omit (or use an unknown ID) to create a new facet page.

integer

Active status (1 for active, 0 for inactive)

integer

Category super ID (if applicable)

integer

Category ID (if applicable)

integer

Subcategory ID (if applicable)

integer

Object ID (if applicable)

integer

Whether to include this facet in the sitemap (1 for yes, 0 for no)

integer

Meta robot directive (1 for index, 0 for noindex)

integer

Whether to use the generic footer on this facet (1 for yes, 0 for no)

integer

Whether to use the generic pre-footer on this facet (1 for yes, 0 for no)

integer

Whether to use the generic pre-footer on this facet (1 for yes, 0 for no)

string

Conditions for the facet, pipe separated (format depends on the facet type). A price condition uses the raw operator key: price:<less_than|greater_than|equal_to>/, e.g. price:greater_than/150

integer

Whether to create an internal link for this facet (1 for yes, 0 for no)

integer

Site ID (required for creation, ignored for update)

translations
object
required

Translations keyed by language ISO code

Responses

Updated 6 months ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago

Did this page help you?