---
title: "Revoke Gift Code Batch"
method: POST
path: "/api/admin/gift-codes/revoke"
tags: ["admin"]
---

# Revoke Gift Code Batch

`POST /api/admin/gift-codes/revoke`

## Request

- Base URL: `https://api.stellara.natlex.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stellara.natlex.it/api/admin/gift-codes/revoke`
- Auth: HTTP bearer

Revoke unredeemed gift codes after a Stripe refund/dispute.

Activated gift codes remain active by policy: refunds are only allowed
before activation, and a buyer action must not remove Pro from a recipient.

## Request body

- GiftCodeRevokeRequest
  - `order_id` string, required
  - `reason` string, nullable

## Response `200`

Successful Response

- GiftCodeRevokeResponse
  - `order_id` string, required
  - `total_count` integer, required
  - `revoked_count` integer, required
  - `redeemed_count` integer, required
  - `already_inactive_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/natlex/apis/stellara-api.md) · [All operations](https://skmtc.dev/natlex/apis/stellara-api/llms.txt) · [OpenAPI document](https://skmtc.dev/natlex/apis/stellara-api/revisions/e576f046b61f?raw)