---
title: "Revert the utilization of one or more rewards for a specified customer."
method: POST
path: "/api/v1alpha1/rewards:rollback"
tags: ["RewardsService"]
---

# Revert the utilization of one or more rewards for a specified customer.

`POST /api/v1alpha1/rewards:rollback`

This endpoint is intended to invalidate the use of the cashback that was previously locked. Upon rollback, the cashback becomes available for use in the next lock and is no longer accessible for commits.

To employ this endpoint, you need to provide the lock_token generated during the locking process.

Certain restrictions apply to performing the rollback. For instance, the lock must not have been generated more than 24 hours ago, among other specified conditions.

## Headers

- `Brand` string, required

## Request body

- V1alpha1RollbackRewardsRequest
  - `lockId` string — Deprecated.
  - `lockToken` string — Lock identifier generated for rewards.

## Response `200`

A successful response.

- object

## Other responses

- `400` — When an invalid request is sent.
- `401` — When the authentication is failed.
- `403` — when it was not authorized.
- `default` — An unexpected error response.

---

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