# Grant AI tokens to a case (internal)

**POST /admin/billing/token-grants**

Adds `tokens` to the case's AI token allowance and returns the new allowance and usage. When the organization is on case billing the grant also shows on its statement as a $0 item, and a repeated `requestId` does not grant again. Returns 404 for an unknown case. Super admin only.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters



### Body: application/json (object)

- **caseId** (string)
  Id of the case to grant tokens on

- **tokens** (number)

- **reason** (string)
  Required audit reason — persisted on the BillingEvent

- **requestId** (string)
  Client-supplied dedup token — repeating the same requestId for the same case returns the prior grant untouched instead of granting a second time. Requires the organization to already have a BillingProfile to be enforced.



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)