---
title: "POST /v1/{+name}:markClaimed"
method: POST
path: "/v1/{+name}:markClaimed"
tags: ["billingAccounts"]
---

# POST /v1/{+name}:markClaimed

`POST /v1/{+name}:markClaimed`

Marks the Recommendation State as Claimed. Users can use this method to indicate to the Recommender API that they are starting to apply the recommendation themselves. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationClaimed can be applied to recommendations in CLAIMED, SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

## Path parameters

- `name` string, required

## Request body

- GoogleCloudRecommenderV1MarkRecommendationClaimedRequest — Request for the `MarkRecommendationClaimed` Method.
  - `stateMetadata` object — State properties to include with this state. Overwrites any existing `state_metadata`. Keys must match the regex `/^a-z0-9{0,62}$/`. Values must match the regex `/^[a-zA-Z0-9_./-]{0,255}$/`.
  - `etag` string — Required. Fingerprint of the Recommendation. Provides optimistic locking.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/recommender.md) · [All operations](https://skmtc.dev/google/apis/recommender/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/recommender/revisions/f31252c26a24/schema)