---
title: "Updates a featured recommendation"
method: PUT
path: "/recommendation/featured"
tags: ["Recommendation"]
---

# Updates a featured recommendation

`PUT /recommendation/featured`

## Request

- The document declares no server URL.
- Auth: API key in header `TWN-InstanceKey` and API key in header `TWN-Authentication`

## Request body

- FeaturedRecommendationSubmitApiModel: Submit model for creating or updating a featured recommendation.
  - `RecommendationId` integer, nullable: Featured recommendation identifier. Required for update, ignored for create.
  - `Name` string: Name of the featured recommendation.
  - `BuilderId` integer, nullable: Builder identifier.
  - `AmountOfResults` integer: Number of products to return.
  - `CategoryId` integer: Category identifier for the recommendation.
  - `SortingId` integer: Sort option identifier.
  - `RecommendationRefinedSelection` 'None' | 'Category' | 'Attribute': Type of refined selection for featured and product recommendations.
  - `RefinedSelectionAttributeId` integer, nullable: Attribute identifier for refined selection when RefinedSelection is Attribute.
  - `Filters` FeaturedRecommendationFilterAttributeApiModel[]: List of attribute filters for this recommendation.
    - `AttributeId` integer: Attribute identifier for this filter.
    - `Type` 'MultiValue' | 'Range': Type of filter for featured recommendation filters.
    - `Operator` 'Equals' | 'NotEquals': Operator for featured recommendation filters.
    - `Values` string[], nullable: Values for MultiValue filter type. Null for Range type.
    - `Min` integer, nullable: Minimum value for Range filter type. Null for MultiValue type.
    - `Max` integer, nullable: Maximum value for Range filter type. Null for MultiValue type.
  - `IncludeExcludeParameters` integer[]: List of dynamic parameter attribute identifiers.
  - `IsBuilderComponent` boolean: Indicates if this recommendation is a builder component.

## Response `200`

OK

- integer

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/tweakwise/apis/app-api.md) - [All operations](https://skmtc.dev/tweakwise/apis/app-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tweakwise/apis/app-api/revisions/dc936bf76941?raw)