---
title: "Update recommendations"
method: PATCH
path: "/v2/optimize/recommendations"
tags: ["recommendations"]
---

# Update recommendations

`PATCH /v2/optimize/recommendations`

Bulk-update one or more recommendations. Supports changing status, effort level, and work item linkage. An optional reason can be provided for audit purposes.

## Request body

- UpdateRecommendationBody — Request body for bulk-updating recommendations.
  - `recommendation_ids` string[], required — One or more recommendation IDs to update
  - `updates` MutableRecommendationFields, required — The fields that can be updated on a recommendation.
    - `effort` 'not_set' | 'low' | 'medium' | 'high'
    - `status` 'not_started' | 'in_progress' | 'addressed' | 'ignored'
    - `work_item` union — Link to an external work item. Pass an empty object {} to unlink.
      - WorkItemLink — Links a recommendation to an external work item in a configured ticketing system.
        - `ticket_id` string, required — The ID of the ticket in the external ticketing system
        - `integration_id` string, required — The ID of the configured ticketing integration
        - `external_id` string, nullable — The external identifier for the work item (optional for backwards compatibility)
      - object
  - `reason` string, nullable — An optional reason for the update, recorded in the activity log (max 256 characters)

## Response `200`

Successful Response

- UpdateRecommendationResponse
  - `recommendation_ids` string[] — The IDs of the recommendations that were updated
  - `updates` object — The updates that were made to the recommendations
  - `reason` string, nullable — The reason for the update
  - `status` string — The status of the update operation
  - `updated_ts` integer — The timestamp of the update

## Other responses

- `422` — Validation Error

---

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