---
title: "POST /v1/pvt/Rewards/updatemetadata"
method: POST
path: "/v1/pvt/Rewards/updatemetadata"
tags: ["Rewards"]
---

# POST /v1/pvt/Rewards/updatemetadata

`POST /v1/pvt/Rewards/updatemetadata`

## Request body

- RewardUpdateMetadataRequest
  - `OriginalKey` string — The same `OriginalKey` used on reward redeeming
  - `Metadatas` object[] — A list of name-value that will be added to the point metadatas for this reward.
    - `Name` string
    - `Value` string

## Response `200`

- BaseExternalApiResponseOfCouponlessRewardRedeemResponse — Standard response envelope used by the External API.
  - `ErrorMessage` string, nullable — Error message returned when the request fails validation or processing. For warnings and successful responses, consumers should usually inspect `Result`, `Code` and `Severity` first.
  - `ErrorCode` integer, nullable — Legacy numeric error code derived from internal API errors when available. This field is relevant only for error flows that use `ApiResponseErrorDescription`.
  - `Result` CouponlessRewardRedeemResponse
    - `RewardId` integer — This is the unique-id for this reward
    - `Point` CouponlessRewardRedeemPointResponse
      - `PointId` integer
      - `Quantity` integer
      - `Metadatas` object[], nullable
        - `Name` string
        - `Value` string
    - `ExternalCode` string — When sending orders to BonifiQ use this field value in the `Coupon` field for the Order This is necessary so we know that this order used this reward
    - `OriginalKey` string — This is the key that was send in the redeem request
    - `Coupon` RewardRedeemCoupon
      - `CouponCode` string
      - `CouponType` 0 | 1 | 2 | 3 | 4 — 0 = FixedValue 1 = Percent 2 = FreeShipping 3 = DiscountShipping 4 = Others
      - `CouponValue` number
      - `ValidDateStart` string, date-time, nullable
      - `ValidDateEnd` string, date-time, nullable
  - `Code` string, nullable — Endpoint-specific business code formatted as a two-digit string, such as `03` or `07`. This field is available for success, warning and error outcomes.
  - `CodeName` string, nullable — Symbolic enum name associated with `Code`, such as `CheckoutNotFound`.
  - `Severity` 0 | 1 | 2 — 0 = Success 1 = Warning 2 = Error
  - `HasWarning` boolean — Convenience flag that is `true` when `Severity` is `Warning`. Warnings are valid `200 OK` business outcomes and should not be handled as transport or validation errors.
  - `HasError` boolean — Indicates whether the request failed and should be handled as an error response. This flag is reserved for real API errors; warnings must keep this property as `false`.

---

[API](https://skmtc.net/bonifiq/apis/bonifiq-private-apis.md) · [All operations](https://skmtc.net/bonifiq/apis/bonifiq-private-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bonifiq/bonifiq-private-apis/revisions/1c29e55baf55/schema)