---
title: "Grant Coins"
method: POST
path: "/api/admin/coins/grant"
tags: ["admin"]
---

# Grant Coins

`POST /api/admin/coins/grant`

## 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/coins/grant`
- Auth: HTTP bearer

Grant coins to a user.

Writes an admin_audit_log row capturing both the delta and the
target user's ID — essential for chargebacks / abuse investigations
(pre-2026-04-23 this wrote to `coin_transactions` but NOT to
`admin_audit_log`, so the admin tab's audit export missed every
manual coin grant and couldn't answer "which admin granted user X
their current balance").

## Request body

- CoinGrantRequest
  - `user_id` integer, required
  - `amount` integer, required
  - `reason` string

## Response `200`

Successful Response

- AdminCoinGrantResponse
  - `user_id` integer, required
  - `amount` integer, required
  - `new_balance` unknown, 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)