---
title: "Update Complimentary Grant"
method: PATCH
path: "/admin/billing/grants/{grant_id}"
tags: ["admin", "billing"]
---

# Update Complimentary Grant

`PATCH /admin/billing/grants/{grant_id}`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/admin/billing/grants/{grant_id}`
- Auth: OAuth 2
  - Password
  - Token URL: `api/login`

## Path parameters

- `grant_id` string, required

## Request body

- AdminGrantUpdate
  - `ends_at` string, date-time, required
  - `note` string, nullable

## Response `200`

Successful Response

- AdminGrantResponse
  - `id` string, nullable, required
  - `kind` 'free_month' | 'admin' | 'free_offer' | 'referral_week' | 'referral_month' | 'legacy_grace', required
  - `starts_at` string, date-time, required
  - `ends_at` string, date-time, required
  - `active` boolean, required
  - `granted_by` string, nullable, required
  - `granted_by_name` string, nullable, required
  - `note` string, nullable, required
  - `created_at` string, date-time, nullable, required

## Other responses

- `404`: Resource not found
- `422`: Validation Error

## Changes

> 106 revisions in range; 1 not diffed.

- **2026-11-12** `0af74c49ba7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/billing/grants/:grant_id/patch.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/de6afcc9656f?raw)
