---
title: "Grant Credit"
method: POST
path: "/v1/me/admin/credits/grants"
tags: ["model spend"]
---

# Grant Credit

`POST /v1/me/admin/credits/grants`

## Request

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

Owner, 2026-09-30: "give sortonowski@gmail.com 1000$ in credits and full access".

One `credit_grant` row per workspace, added to its starter credit; with
`full_access` the spend guard drops that team's daily caps. Platform facts,
so nothing lands on the team where a client could edit it.

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Request body

- CreditGrantRequest: Credit given by hand — to one workspace, or every workspace a person owns.
  - `team_id` string, uuid, nullable
  - `email` string, nullable
  - `usd` number, required
  - `full_access` boolean
  - `reason` string

## Response `200`

Successful Response

- CreditGrantReceipt
  - `usd` number, required
  - `full_access` boolean, required
  - `teams` CreditGrantTeam[], required
    - `team_id` string, uuid, required
    - `name` string, nullable
    - `grant_id` string, uuid, required

## Other responses

- `422`: Validation Error

## Changes

> 68 revisions in range; 1 not diffed.

- **2026-10-01** `1163a2ce2baa`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stormy/apis/stormy-control-plane/changes/v1/me/admin/credits/grants/post.md)

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/a40e83844eaa?raw)
