---
title: "Update recommender"
method: PUT
path: "/recommenders/{recommender_id}"
tags: ["Recommenders"]
---

# Update recommender

`PUT /recommenders/{recommender_id}`

Update the name and settings (filters) of an existing Spark recommender. Returns the updated list of recommenders.

## Path parameters

- `recommender_id` string, required

## Request body

- object
  - `name` string — Optional human-readable name of the recommender. Max 191 characters.
  - `filtered_products` string — List of product identifiers (SKUs) to exclude from the recommendations. Max 1000 items, each unique and max 255 characters. Omit the field for no product filter.
  - `filtered_categories` string — List of category names to exclude from the recommendations. Max 1000 items, each unique and max 255 characters. Omit the field for no category filter.
  - `included_months` string — List of calendar month numbers (`1`–`12`) that restrict which purchase history is used for training. Values must be unique, max 12 items. Omit the field to use the full purchase history.

## Response `200`

OK

- object[]
  - `recommender_id` string
  - `feed_id` integer
  - `shop_id` string
  - `last_trained_timestamp` integer
  - `status` string
  - `settings` object
    - `filtered_products` string[]
    - `filtered_categories` string[]
    - `included_months` integer[]
  - `sequence_number` integer
  - `name` string

## Other responses

- `404` — Not Found

---

[API](https://skmtc.dev/ecomail/apis/ecomail-api.md) · [All operations](https://skmtc.dev/ecomail/apis/ecomail-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ecomail/ecomail-api/revisions/31b5789931fe/schema)