> ## Documentation Index > Fetch the complete documentation index at: https://docs.depict.ai/llms.txt > Use this file to discover all available pages before exploring further. # Apply one automated sort to many collections > Saves `sort_order` (plus optional collection-specific boost/bury rules) as the main version of up to 100 collections and syncs each back to Shopify; with `publish_non_live`, collections Depict did not manage yet are activated too (plan-capped, 402). Per-collection failures land in `errors`. Returns the rollup. ## OpenAPI ````yaml /api-reference/openapi/lite.json put /collections/bulk-automated-sorting openapi: 3.1.0 info: title: Search & Merchandising API version: 1.0.0 description: >- REST API behind Depict: Search & Merchandising, the native Shopify app: onboarding, collections, boost & bury, dashboards, A/B testing and multi-store management. Endpoints are served under the /api/lite prefix and are authenticated with the Shopify session token that App Bridge issues to the embedded app. servers: - url: /api/lite security: - ShopifySessionToken: [] paths: /collections/bulk-automated-sorting: put: summary: Apply one automated sort to many collections description: >- Saves `sort_order` (plus optional collection-specific boost/bury rules) as the main version of up to 100 collections and syncs each back to Shopify; with `publish_non_live`, collections Depict did not manage yet are activated too (plan-capped, 402). Per-collection failures land in `errors`. Returns the rollup. operationId: collectionBulkSorting parameters: - schema: type: string description: Lite merchant id, e.g. `shopify-`. required: true description: Lite merchant id, e.g. `shopify-`. name: merchant_id in: query requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LiteCollectionsBulkAutomatedSortingInput' responses: '200': description: The rollup. content: application/json: schema: $ref: '#/components/schemas/BulkSortingResult' '400': description: >- The query, path or body failed the schema; `detail` carries zod's messages. content: application/json: schema: $ref: '#/components/schemas/Detail' '401': description: Not authenticated. content: application/json: schema: $ref: '#/components/schemas/Detail' '402': description: >- Activating the non-live collections would exceed the plan's limit, or the installation is frozen. content: application/json: schema: $ref: '#/components/schemas/Paywall' '403': description: Authenticated, but this identity may not call the API. content: application/json: schema: $ref: '#/components/schemas/Detail' '404': description: Merchant not found for this caller. content: application/json: schema: $ref: '#/components/schemas/Detail' '415': description: Content-Type is not application/json. content: application/json: schema: $ref: '#/components/schemas/Detail' '500': description: Internal error. content: application/json: schema: $ref: '#/components/schemas/Detail' components: schemas: LiteCollectionsBulkAutomatedSortingInput: type: object properties: collection_ids: type: array items: type: string minItems: 1 maxItems: 100 description: 1–100 numeric Shopify collection ids; duplicates are applied once. sort_order: type: string enum: - ALPHA_ASC - ALPHA_DESC - BEST_SELLING - BEST_SELLING_BY_REVENUE - MOST_RELEVANT - TRENDING - TRENDING_BY_REVENUE - CREATED - CREATED_DESC - PRICE_ASC - PRICE_DESC - STOCK_DESC - CLICKS_DESC description: >- An automated order. MANUAL (per-collection pins) and METAFIELD_* (a per-version key) cannot be applied in bulk. use_collection_specific_boost_bury: type: boolean collection_boost_rules: type: array items: $ref: '#/components/schemas/BoostBuryRule' default: [] publish_non_live: type: boolean default: false description: Also activate the collections that are not live. unpin_oos: type: boolean default: false required: - collection_ids - sort_order - use_collection_specific_boost_bury BulkSortingResult: type: object properties: updated: type: integer description: Collections the change was applied to. errors: type: array items: $ref: '#/components/schemas/BulkCollectionError' description: Per-collection failures; the rest still applied. warnings: type: array items: type: string published: type: integer description: Collections activated by `publish_non_live`. required: - updated - errors - warnings - published Detail: type: object properties: detail: type: string required: - detail description: 'Every 4xx/5xx body: `{detail}`.' Paywall: type: object properties: detail: type: string code: type: string enum: - product_required - collection_limit_exceeded - installation_frozen product: type: string enum: - search - recs - vm limit: type: integer required: - detail - code description: >- 402: the merchant's plan does not include this. Branch on `code`; show `detail`. BoostBuryRule: oneOf: - type: object properties: strength: type: integer description: >- Priority and direction: > 0 boosts matching products toward the top, < 0 buries them toward the bottom; a larger magnitude wins over a smaller one. top_n: type: - integer - 'null' description: >- Cap: only the first N matching products (best-ranked for a badge rule) are moved; null or absent = every match. type: type: string enum: - badge badge: $ref: '#/components/schemas/ProductBadgeType' required: - strength - type - badge - type: object properties: strength: type: integer description: >- Priority and direction: > 0 boosts matching products toward the top, < 0 buries them toward the bottom; a larger magnitude wins over a smaller one. top_n: type: - integer - 'null' description: >- Cap: only the first N matching products (best-ranked for a badge rule) are moved; null or absent = every match. type: type: string enum: - collection collection_id: type: string description: >- Numeric Shopify collection id (no gid:// prefix); matches that collection's products. required: - strength - type - collection_id - type: object properties: strength: type: integer description: >- Priority and direction: > 0 boosts matching products toward the top, < 0 buries them toward the bottom; a larger magnitude wins over a smaller one. top_n: type: - integer - 'null' description: >- Cap: only the first N matching products (best-ranked for a badge rule) are moved; null or absent = every match. type: type: string enum: - tag tags: type: array items: type: string description: >- Matches products carrying any of these Shopify tags (see GET /boost-bury/tags). required: - strength - type - tags - type: object properties: strength: type: integer description: >- Priority and direction: > 0 boosts matching products toward the top, < 0 buries them toward the bottom; a larger magnitude wins over a smaller one. top_n: type: - integer - 'null' description: >- Cap: only the first N matching products (best-ranked for a badge rule) are moved; null or absent = every match. type: type: string enum: - metafield key: type: string pattern: ^[A-Za-z0-9_-]{1,255}\.[A-Za-z0-9_-]{1,64}$ description: Product metafield as `namespace.key`. metafield_type: type: string enum: - number_integer - number_decimal - single_line_text_field - multi_line_text_field - url - color - date - date_time - boolean - rating - weight - dimension - volume description: >- The metafield's Shopify type; it decides which operators are allowed (measurement types allow only `exists`). operator: type: string enum: - exists - equals - gt - lt description: >- `exists` matches any product with the metafield set; `equals`/`gt`/`lt` compare against `value`. value: type: - string - 'null' description: The compared raw metafield value; null for `exists`. required: - strength - type - key - metafield_type - operator - value description: >- A merchant-wide rule that moves matching products up (boost) or down (bury) in every automatically sorted collection. `type` selects how products match. BulkCollectionError: type: object properties: collection_id: type: string error: type: string required: - collection_id - error ProductBadgeType: type: string enum: - on_sale - out_of_stock - new_in - bestseller - bestseller_revenue - slow_mover - few_variants_available - partially_out_of_stock - partially_low_stock - trending - trending_revenue - tag - collection description: Matches products currently carrying this badge. securitySchemes: ShopifySessionToken: type: http scheme: bearer bearerFormat: JWT description: >- Shopify App Bridge session token of the embedded Depict: Search & Merchandising app. The shop in the token determines the merchant; merchant_id parameters must belong to that shop. ````