---
title: "Grant Tokens"
method: POST
path: "/admin/grant"
tags: ["accepts-api-key"]
---

# Grant Tokens

`POST /admin/grant`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/admin/grant`
- Auth: none declared

Grant tokens to a user by email. Admin only.

Creates a one-time grant of ``quantity`` tokens that expires
``expiration_days`` days from today, returning the grant id and the
computed expiration date.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- GrantTokensRequest
  - `email` string, required: Email of the user to grant tokens to
  - `quantity` number, required: Number of tokens to grant
  - `expiration_days` integer, required: Number of days from today after which the grant expires

## Response `200`

Successful Response

- GrantTokensResponse
  - `grant_id` string, uuid, required: Id of the created grant
  - `expiration_date` string, date, required: Date on which the grant expires

## Other responses

- `422`: Validation Error

---

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